SuperAPI AI 工具集

paths

编程与开发

查看项目

更新于 10-16 06:55

技能介绍

用途

该技能针对 /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 配置、测试、仅桌面端的扩展、仅使用宿主文件系统的工具。