必须重装VSCode到纯英文路径，因中文路径导致Extension Development Host启动失败、npm编译报spawn ENOENT、调试器无法attach，根源是Node.js child_process和Electron底层依赖Windows系统代码页（CP936）解析路径，配置无法修复。
VSCode插件开发时中文路径报错：必须重装到英文路径
插件开发环境下，vscode 安装路径含中文（如 C:Users张三AppDataLocalProgramsMicrosoft VS Code）会导致 Extension Development Host 启动失败、npm run compile 报 spawn ENOENT、调试器无法 attach——这不是环境变量能绕过的，是 Node.js child_process 和 Electron 底层路径解析在 Windows 上硬编码依赖系统代码页（CP936）导致的崩溃。
修复方式只有且必须：卸载后重装到纯英文路径，例如：C: ools scode 或 D:dev scode。重装前记得备份 %USERPROFILE%.vscodeextensions 目录。
- 控制面板卸载 → 手动删残留
%LOCALAPPDATA%ProgramsMicrosoft VS Code - 安装时自定义路径，确保无空格、无中文、无符号（如
&、(） - 重装后用命令行验证：
code --version能正常输出，且which code返回英文路径
插件调试时终端/Output面板中文乱码：改 settings.json 不够
插件开发中，Debug Console 或 Output 面板打印中文日志显示为 ，常误以为是 files.encoding 没设对——实际是 VSCode 的调试子进程（如 node、electron）未继承 UTF-8 环境，和编辑器主进程编码无关。
需在插件项目根目录的 .vscode/launch.json 中显式注入编码环境：
{
"configurations": [
{
"type": "pwa-node",
"request": "launch",
"name": "Launch Extension",
"runtimeExecutable": "${env:USERPROFILE}\AppData\Local\Programs\Microsoft VS Code\Code.exe",
"args": ["--extensionDevelopmentPath=${workspaceFolder}"],
"outFiles": ["${workspaceFolder}/out/**/*.js"],
"env": {
"NODE_OPTIONS": "--max_old_space_size=4096",
"CHCP": "65001"
},
"console": "integratedTerminal"
}
]
}
-
env.CHCP是 Windows 终端生效的关键，Linux/macOS 改用LANG=zh_CN.UTF-8 - 若用
integratedTerminal，还需在全局settings.json加："terminal.integrated.env.windows": { "CHCP": "65001" } - 仅设
"files.encoding": "utf8"对调试输出无效——那是文件读写用的
插件 UI 中文显示异常：别只改 package.nls.json
插件里用 vscode.window.showInformationMessage('你好') 弹窗显示方块或问号，不是翻译文件没加载，而是 VSCode 主体语言没切到中文，或字体 fallback 缺失。
分两步验证：
- 先确认 VSCode 自身界面是中文：装
Chinese (Simplified) Language Pack for Visual Studio Code插件，重启后按Ctrl+Shift+P→Configure Display Language→ 选zh-cn→ 重启 - 再检查插件 UI 字体：在插件代码中加
vscode.window.showQuickPick(['测试中文'])，若仍乱码，说明 Electron 渲染层未加载中文字体。此时需在package.json的contributes下加："icon": "resources/icon.png"（任意 PNG），强制触发资源加载流程 - 终极兜底：在
extension.js开头加document.body.style.fontFamily = "'Microsoft YaHei', sans-serif";（仅限 Webview 场景）
插件调试时搜索框无法输入中文：Electron IME 必须显式启用
在插件开发 Host 窗口中，Ctrl+P 或 Ctrl+Shift+F 搜索框按 Ctrl+Space 无响应，即使宿主 VSCode 本身能输中文——这是因为插件开发 Host 是独立 Electron 实例，默认不继承主进程的输入法环境变量，且 Wayland/X11 协议协商完全隔离。
临时验证命令（Windows）：
code --extensionDevelopmentPath="D:my-ext" --ozone-platform=x11 --disable-gpu
长期生效需修改插件调试启动方式：
- Windows：在
launch.json的runtimeExecutable后追加--ozone-platform=x11 --disable-gpu - Linux：必须确保宿主会话是 X11（
echo $XDG_SESSION_TYPE输出x11），Wayland 下即使加 flag 也大概率失效 - macOS：无需额外操作，但需确认系统偏好设置 → 键盘 → 输入法已启用，且
INPUT_METHOD环境变量非必需
真正容易被忽略的是：插件开发 Host 的 Electron 版本通常比宿主低，--ozone-platform=x11 在 v22+ 才稳定支持；若用旧版 VSCode 开发，降级 Electron 或升级 VSCode 更可靠。
