用途
该技能针对 /src 目录下的 .ts 文件,规定在涉及路径处理时优先使用 vscode-uri 的 URI,而不是 node:path 的路径字符串。其目标是统一使用 URI 表示文件位置,从而兼容 file 与 memfs、支持跨平台,并适配 FsService/workspace.fs 接受 URI 的接口。
主要能力
- 用 vscode-uri 的工具函数替代 node:path:
- Utils.joinPath(baseUri, 'a', 'b') 对应 path.join
- Utils.basename(uri)、Utils.dirname(uri)、Utils.extname(uri) 对应 path.*
- Utils.resolvePath(baseUri, 'rel') 对应 path.resolve
- 通过 FsService 在 URI 与路径之间转换:toUri(filePath) / uriToPath(uri)(Effect;配合 salesforcedx-vscode-services 的扩展)。
- 原始路径转 URI:使用 URI.file(path),或在 web 环境下对 memfs 使用 toUri。
- FsService 的配置参考:services-extension-consumption。
使用方式
在 /src 下的 .ts 文件中,当需要拼接、解析或提取路径信息时,改用 vscode-uri 的 Utils 方法;当需要在 URI 与路径之间转换时,使用 FsService 的 toUri/uriToPath;当需要从原始路径构造 URI 时,使用 URI.file(path),web 环境下 memfs 使用 toUri。
适用场景
适用于 .ts 文件位于 /src 且出现以下情况时:导入 node:path,或使用 path.join/basename/dirname/resolve、URI.file、memfs 路径。
限制与例外
以下情况可以使用 node:path:构建脚本、esbuild 配置、测试、仅桌面端的扩展、仅使用宿主文件系统的工具。