必须重装VSCode到纯英文路径，因中文路径导致Git、调试器、Python插件等底层依赖因UTF-8与GBK编码冲突而启动失败，且无法通过配置修复；需先卸载重装，再关闭Windows UTF-8 Beta选项，最后配置launch.json环境变量。
VSCode 安装路径含中文必须重装
不能靠配置修复，必须卸载后重装到纯英文路径。VSCode 的安装注册表项、code CLI 入口、快捷方式目标、插件缓存路径全部硬编码原始路径，改 settings.json 或环境变量完全无效。
常见错误现象包括：Command failed: git status、spawn git ENOENT、调试器报 Unable to launch program 'D:\开发\main.py'（路径被截断）、Python 插件提示 ModuleNotFoundError 实际是 sys.executable 路径里的中文被误解析。
- 卸载前备份
%USERPROFILE%\.vscode\extensions目录 - 控制面板 → 卸载程序 → 彻底卸载 VSCode
- 手动删除残留：
%LOCALAPPDATA%\Programs\Microsoft VS Code - 重装时自定义路径必须全英文、无空格、无符号，例如：
C:\tools\vscode或D:\dev\vscode - 安装完运行
Ctrl+Shift+P→Developer: Toggle Developer Tools，检查 Console 是否还有ERR级路径错误
Windows 系统区域设置必须关掉 UTF-8 Beta 选项
这是所有中文路径问题的根因。勾选「Beta版：使用Unicode UTF-8提供全球语言支持」会导致 Node.js 子进程对 argv 中的路径二次编码，VSCode 收到的是乱码字符串，直接触发 Unable to resolve non-existing file 或空白标签页。
操作步骤：
- 控制面板 → 区域 → 管理 → 更改系统区域设置 → 取消勾选该选项
- 必须重启电脑（仅改设置不重启无效）
- 验证：CMD 中运行
chcp，输出应为936，不是65001
launch.json 必须加三项环境变量
即使安装路径和系统设置都正确，Python 调试仍会因子进程用 GBK 解码 UTF-8 路径而报 FileNotFoundError 或卡在 launch 阶段。这不是文件不存在，是编码错位。
在 .vscode/launch.json 的对应 configuration 的 env 字段中，必须写入：
"env": {
"PYTHONIOENCODING": "utf-8",
"PYTHONUTF8": "1",
"PYTHONPATH": "${workspaceFolder}"
}
-
PYTHONIOENCODING强制标准输入输出走 UTF-8，避免 print 输出变问号 -
PYTHONUTF8启用 Python 3.7+ 内置 UTF-8 模式，绕过 Windows 系统 locale -
PYTHONPATH防止相对导入时因工作目录不对再次触发路径解析失败
tasks.json 和 Code Runner 的路径写法陷阱
MinGW/GCC/g++ 在 GBK 代码页下解析反斜杠+中文组合时，会被 CommandLineToArgvW 误判为非法转义序列，直接截断，表现为 no input files 或 unrecognized command line option。
正确写法要点：
- 路径变量统一用正斜杠：
"${fileDirname}/${fileBasename}"（VSCode 自动兼容） -
args数组中每个路径必须单独成项，禁止拼进字符串：
✅"args": ["g++", "${file}", "-o", "out.exe"]
❌"args": ["g++ \"${file}\" -o out.exe"] - Code Runner 插件需开启
code-runner.runInTerminal，并修改code-runner.executorMap中的命令，例如 Python 改为：python -u "${file}"（注意双引号要转义） - 绝对不要用全角空格、中文括号、顿号——它们比汉字更容易触发截断
真正麻烦的不是“怎么配”，而是路径编码链涉及 VSCode、Node.js、Python、Windows API 四层，任一环节错位都会崩。很多人只改 launch.json 却忽略系统区域设置，或只关 UTF-8 Beta 却没重装 VSCode，结果反复踩坑。顺序不能乱：先重装、再关系统选项、最后配 launch.json 和 tasks.json。
