VSCode插件路径问题需严格区分开发与发布环境，main/browser字段须指向构建产物，静态资源用vscode.Uri.file()，WebView资源用webview.asWebviewUri()，跨平台路径用path.join()，并验证文件存在性。
VSCode 插件开发中，路径问题不是“写对就行”，而是直接影响插件能否加载、资源能否访问、跨平台是否稳定。绝大多数运行时失败（比如 Cannot find module、Failed to load extension、图片/图标 404）都源于路径处理不当。
package.json 中的 main 和 browser 字段必须指向编译后产物
VSCode 插件启动时只加载 main（桌面端）或 browser（Web 扩展）字段指定的 JS 文件，且该路径是相对于插件根目录的**运行时路径**，不是源码路径。
- 如果你用 TypeScript 开发，
main必须写成"./out/extension.js"，而不是"./src/extension.ts"—— VSCode 不会编译 TS -
out/目录需由tsc构建生成；若你改用esbuild或vite，就要同步更新main指向，比如"./dist/extension.js" - Web 扩展（
browser）路径不能和main冲突，且 Web 环境下不支持require()动态加载 Node.js 模块，路径必须是静态可分析的 - 路径里不要用
../跳出插件根目录 —— VSCode 加载器不会解析上级路径，会直接报错Unable to resolve
静态资源（图标、HTML、CSS）要用 vscode.Uri.file() 转绝对路径
直接拼接字符串路径（如 "./media/icon.svg"）在 Web 扩展或远程开发（SSH/WSL）场景下必然失效，因为文件系统上下文不同。
- 正确做法：用
vscode.Uri.file(path.join(context.extensionPath, "media", "icon.svg")) -
context.extensionPath是插件安装后的**实际磁盘路径**，每次启动都可靠；而__dirname在打包后可能指向临时目录，不可信 - HTML WebView 中引入 CSS/JS，必须用
webview.asWebviewUri()转换，否则被 CSP 拦截 —— 这不是路径写错，是安全策略强制要求 - 图标路径若用于
package.json的icon字段，只能是插件根目录下的相对路径（如"media/icon.png"），且必须是 PNG，不支持 SVG
多平台路径分隔符必须用 path.join()，不能硬写 / 或 \
Windows 下用正斜杠 / 有时能“碰巧”工作，但 Linux/macOS 下反斜杠 \ 一定失败，且 Node.js 的 fs 模块在不同平台对路径解析行为不一致。
- 所有拼接路径的地方，统一用
const p = path.join(context.extensionPath, "data", "config.json") - 避免
context.extensionPath + "/data/config.json"或模板字符串拼接 - 读取 JSON 配置时，
fs.readFileSync(p, "utf8")前务必先fs.existsSync(p)—— 插件路径存在，不代表子路径一定存在 - 如果用 ESM（
import fs from "fs"），注意 Node.js 版本兼容性；VSCode 当前嵌入的 Node.js 版本固定（随 VSCode 发布周期更新），别依赖太新的 API
调试时 context.extensionPath 指向源码目录，但发布后指向 extensions/ 下的安装目录
这是最常被忽略的差异：开发时你跑的是未编译的源码，而用户安装的是打包后的产物。路径结构稍有不同，就会导致“本地能跑，发布就挂”。
- 开发时
context.extensionPath指向你的项目根目录（含src/、package.json）；发布后它指向~/.vscode/extensions/publisher-name.extension-name-version/，里面只有out/、media/等构建产物 - 因此，任何依赖
src/目录的逻辑（比如动态读取src/utils/*.ts）在发布版里根本不存在，必须提前构建好或改用其他方案 - 建议在
activate()开头加一行日志：console.log("Extension path:", context.extensionPath)，发布前手动验证路径内容是否符合预期 - CI/CD 打包时，确保
vsce package或webpack配置把所有需要的资源（字体、模板 HTML、语言包）都复制进最终包，而不是靠开发时的相对位置侥幸运行
路径问题的复杂点不在写法本身，而在它横跨了开发、构建、运行、发布四个阶段，且每个阶段的文件系统上下文都不同。最容易被忽略的是：你以为的“当前目录”，对 VSCode 来说从来都不是你期望的那个。
