必须将vscode相关路径（安装路径、用户目录、插件源码、虚拟环境等）全部改为纯英文，因windows下gbk与utf-8编码错位会导致process.argv路径乱码，引发插件加载硬性崩溃，配置无效，需逐项排查并清除所有中文路径节点。
VSCode插件加载失败，只要路径里含中文（无论是安装路径、用户目录、插件源码路径还是虚拟环境路径），就大概率不是配置问题，而是 Windows 下 GBK 与 UTF-8 编码错位引发的硬性崩溃——改配置没用，必须移路径。
检查 process.argv 是否已乱码
这是最直接的判断依据：插件宿主进程启动时，如果传入的路径参数在 process.argv 里出现问号、方块或截断（如 C:Users???.vscodeextensions），说明底层 spawn 已失败。此时插件根本没机会执行 activate 函数。
- 在插件
extension.ts的activate函数开头加console.log("argv:", process.argv)，然后 F5 启动调试 - 若输出中
__filename或process.argv[1]显示乱码，确认是路径编码问题，不是插件逻辑错误 - 不要依赖
__dirname拼接路径——它在乱码 argv 下返回的也是错的
定位具体哪个中文路径在作祟
VSCode 插件链涉及多个独立路径环节，需逐个排除：
-
VSCode 安装路径：比如C:Program FilesVisual Studio Code是安全的；C:Program Files微软 VS Code必崩 -
%USERPROFILE%：即C:Users张三，它决定.vscodeextensions和Usersettings.json所在位置，无法绕过 -
插件源码根目录：开发时若把my-extension放在D:项目ext，vsce package或npm run compile会直接报ENOENT -
.venv路径：Python 插件调用python -c "import sys; print(sys.executable)"时，路径含中文会导致sys.executable返回空或乱码
用 code --extensions-dir 临时隔离插件路径
这是验证是否为插件安装路径问题的最快方式——不重装、不改账户，仅测试。
- 关闭所有 VSCode 窗口
- 新建一个纯英文路径，例如
D: scode-ext - 命令行运行：
code --extensions-dir "D: scode-ext" - 此时 VSCode 会清空原
%USERPROFILE%.vscodeextensions并从空目录开始，再手动安装几个关键插件测试 - 如果插件能正常启用，说明原
%USERPROFILE%路径里的中文是元凶
launch.json 里别让 ${workspaceFolder} 参与路径构造
即使插件本身路径干净，launch.json 中的变量展开仍可能触发乱码——尤其当 env 或 args 字段拼接路径时。
- 避免写
"args": ["--extensionDevelopmentPath=${workspaceFolder}"]，因为变量展开后若含中文，code命令行参数直接失效 - 改用硬编码英文路径：
"args": ["--extensionDevelopmentPath=D:\dev\my-extension"]（注意双反斜杠） - 优先用
${workspaceFolderBasename}替代${workspaceFolder}，它只取文件夹名，不带路径，天然规避问题 - 调试前可在
activate里加console.log(__filename)，确认实际加载的是不是你预期的那个文件
真正麻烦的不是“怎么修”，而是“哪里在修”：Windows 上路径乱码是链式反应，code 启动 → child_process.spawn → tsc 或 python.exe → 插件自身 fs.readFile，任一环卡住，后续全废。别指望某个配置开关能兜底，优先砍掉所有中文路径节点，比调一百次 settings.json 更有效。
