VSCode插件管理出错因中文路径导致，需将VSCode安装路径、插件源码路径、工作区路径及资源文件名全部改为纯英文。
VSCode 插件管理出错，只要报 ENOENT、spawn ENOENT、MODULE_NOT_FOUND 且路径里有中文（比如 D:\项目\my-ext\package.json），基本可以确定不是插件本身写错了，而是 Windows 下 Node.js 和 VSCode 工具链对中文路径的解析完全失效——改配置没用，必须改路径。
vsce package 报 “no such file or directory”
这是最典型的症状，vsce package 找不到 package.json 或资源文件，错误信息里路径显示为乱码或直接截断。根本原因不是你没写对路径，而是 vsce 底层依赖的 zip-stream 在 Windows 上无法正确处理非 ASCII 路径。
- 插件源码根目录必须是纯英文路径，例如
D:\dev\my-extension，不能含空格、中文、括号、点号等 -
tsconfig.json中显式指定"outDir": "./dist"，避免生成路径继承 workspace 的中文名 -
launch.json的outFiles字段写死为["${workspaceFolder}/dist/**/*.js"]，不要拼接变量或相对路径 - 删除整个
dist目录后重新运行npm run compile，确认生成的 JS 文件路径确实不含中文
插件安装后崩溃或“Extension host terminated unexpectedly”
这类错误往往发生在用户安装你的插件后，而不是你本地开发时。常见于插件代码中硬编码了中文路径，比如用 path.join(__dirname, '配置文件.txt') 加载资源。Node.js 的 fs.readFile 在英文系统 locale 下遇到中文文件名会直接抛错。
- 所有资源路径必须用英文名：配置文件 →
config.json，图标 →icon.svg，不要用设置说明.md - 读取资源时优先用
vscode.ExtensionContext.asAbsolutePath，它能自动转义路径，比__dirname+path.join更可靠 - 如果必须动态拼路径，先检查
process.env.VSCODE_NLS_CONFIG中的locale，再决定加载哪个语言资源，而非直接拼中文文件名 - 发布前在干净的英文 Windows 虚拟机里测试安装和启用流程，只装你的插件，不装其他扩展
VSCode 自身安装路径含中文，导致插件无法启用
这不是你的插件问题，但用户会归咎于你。VSCode 安装在 C:\Users\张三\AppData\Local\Programs\Microsoft VS Code 这类路径下时，code CLI、插件缓存、注册表项全部硬编码该路径，任何配置都绕不过去。
- 必须卸载重装 VSCode 到纯英文路径，例如
C:\tools\vscode或D:\dev\vscode - 重装前备份
%USERPROFILE%\.vscode\extensions，重装后手动复制过去（不要用--extensions-dir指向原中文路径） - 系统区域设置里关闭「Beta版：使用 Unicode UTF-8 提供全球语言支持」，否则
chcp输出会是65001，而 Node.js 子进程仍按936解析参数，造成双重乱码 - 验证方式：打开命令面板 →
Developer: Toggle Developer Tools→ Console 里搜ERR，不应出现路径相关的错误
插件调试时断点不命中或跳转失效
断点变灰、F12 跳转到 undefined、Source Map 映射失败——这些不是 TypeScript 编译问题，而是 outFiles 路径含中文导致 source-map-support 模块无法解析原始位置。
-
launch.json中的outFiles必须是绝对路径的英文形式，推荐写成["${workspaceFolder}/dist/**/*.js"]，不要用${workspaceFolderBasename}或./dist -
tsconfig.json的sourceMap和inlineSources都设为true，确保 map 文件包含原始内容 - 调试前手动删掉
dist目录，运行tsc -b重新生成，检查生成的.js.map文件里sources字段是否为相对路径（如../src/extension.ts），而不是绝对中文路径 - 如果工作区路径是
C:\Users\张三\vscode-ext，哪怕outFiles写对了，Node.js 也会在内部把sources解析成乱码，所以工作区路径也必须是英文
最易被忽略的一点：问题常出现在“看起来能用”的边界上——比如插件 UI 正常、命令能触发，但一调用 child_process.spawn 或读取本地文件就崩。这时候别查逻辑，先看路径是不是全英文，从 VSCode 安装路径、插件源码路径、用户工作区路径、资源文件名，四层全压一遍。
