必须将VSCode重装到纯英文路径，因中文路径会导致Git、调试器、Python插件等底层依赖因UTF-8与GBK编码冲突而启动失败，且无法通过配置修复。
VSCode 安装路径含中文会导致部分插件、终端子进程、Git 集成、调试器启动失败，不是“能用就行”，而是根本性兼容问题——必须改路径，不能绕。
为什么安装路径含中文会出错
VSCode 本身可以运行在中文路径下，但大量底层依赖（如 Python 的 subprocess、Node.js 的 child_process、Git 的 git.exe、C++ 调试器 cppvsdbg）在 Windows 上默认使用系统代码页（CP936/GBK）解析路径参数。而 VSCode 内部路径处理、插件 API、launch.json 解析等环节又按 UTF-8 处理。两者一碰就崩，典型表现：
-
Command failed: git status或spawn git ENOENT（Git 找不到） - 调试器报
Unable to launch program 'D:\开发\main.py'（路径被截断或转义） - Python 插件提示
ModuleNotFoundError，实际是sys.executable路径里中文被误解为非法字符 - 终端中
which code或code --version失败
必须重装到纯英文路径（非设置可修复）
这不是配置项能救的——VSCode 的安装注册表项、快捷方式目标、code CLI 入口、插件缓存路径都硬编码了原始安装路径。改 settings.json 或环境变量无效。
- 卸载前先备份
%USERPROFILE%\.vscode\extensions（扩展目录），避免重装后重新下载 - 彻底卸载：控制面板 → 卸载程序 → 找到 Visual Studio Code → 卸载；再手动删残留：
%LOCALAPPDATA%\Programs\Microsoft VS Code - 重装时，自定义安装路径必须为全英文、无空格、无符号，例如：
C:\tools\vscode或D:\dev\vscode - 安装完成后，打开命令面板（
Ctrl+Shift+P），运行Developer: Toggle Developer Tools，检查 Console 是否还有ERR级路径错误
已安装但不想重装？临时缓解方案有限
仅适用于极少数场景（如临时演示），且不保证所有功能正常：
- 把 VSCode 快捷方式目标改为：
"C:\Program Files\Microsoft VS Code\Code.exe" --disable-gpu --no-sandbox（加参数有时能绕过部分路径解析） - 在终端中手动切换代码页：
chcp 65001，再启动 VSCode（需每次开终端都执行） - 禁用所有非核心插件，逐个启用测试，确认哪些插件明确不支持中文路径（常见于 GitLens、C/C++、Remote-SSH）
- 绝对不要尝试用符号链接（
mklink）把中文路径映射到英文路径——Windows 符号链接对 GUI 应用支持极差，多数插件直接忽略
后续避坑：工作区路径也别用中文
即使 VSCode 自身装在英文路径，若你的项目放在 D:\我的项目\src，仍可能触发类似问题：
- Git 提交时路径显示为
"\u6211\u7684\u9879\u76ee" - Python
venv激活脚本执行失败（Activate.ps1报无法加载） - WSL 集成中路径映射异常，
/mnt/d/\u6211\u7684... - 解决方案：工作区路径保持英文，中文名用文件夹别名或注释说明即可
路径里的中文看似小事，实则是跨进程、跨语言、跨工具链的编码撕裂点。重装一次比排查三天奇怪报错更省时间。
