根本原因是windows utf-8区域设置引发编码链断裂，需取消「beta版:使用unicode utf-8提供全球语言支持」并重启；cmd中chcp应显示936；vscode路径用正斜杠、args独立成项；python调试需设pythonioencoding=utf-8和pythonutf8=1；git中文路径显示异常则执行git config --global core.quotepath false。
VSCode在Windows下因路径含中文报错，根本不是“不支持中文路径”，而是编码链断裂+系统底层转义逻辑冲突导致的连锁故障。直接关掉Windows的UTF-8区域设置，比调一堆VSCode参数更治本。
Windows系统区域设置必须取消UTF-8 Beta选项
这是所有中文路径问题的起点。一旦勾选「Beta版:使用Unicode UTF-8提供全球语言支持」，Node.js子进程会把VSCode传入的UTF-8路径二次编码成乱码，Unable to resolve non-existing file或空白标签页就是典型症状。
- 打开「控制面板 → 区域 → 管理 → 更改系统区域设置」，取消勾选该选项
- 重启电脑（仅改设置不重启无效）
- 验证：CMD中运行
chcp，输出应为936，不是65001 - 若VSCode已无法启动，先用
code --disable-extensions --no-sandbox临时进入，再改设置
tasks.json里路径拼接必须用正斜杠+独立args项
MinGW/GCC等工具链在GBK代码页下解析反斜杠+中文组合时，会被CommandLineToArgvW误判为非法转义序列，直接截断，表现为no input files或unrecognized command line option。
- 路径变量统一用正斜杠：
"${fileDirname}/${fileBasename}"（VSCode自动兼容） -
args数组中每个路径必须单独成项，禁止拼接进字符串：
✅"args": ["-g", "${file}", "-o", "${fileDirname}/output/a.exe"]
❌"args": ["-g \"${file}\" -o \"${fileDirname}/output/a.exe\""] - 避免中文括号、顿号、全角空格——它们比汉字更容易触发截断
Python调试时中文路径报错要补环境变量
VSCode内部用UTF-8传递路径URI，但Python子进程默认继承CP936编码，导致FileNotFoundError或卡在launch阶段。这不是文件不存在，是Python用GBK去decode一个UTF-8字符串。
- 在
launch.json的env字段中加："PYTHONIOENCODING": "utf-8"和"PYTHONUTF8": "1" - 确保
console设为integratedTerminal或externalTerminal，别用none - 如果用了
python.defaultInterpreterPath指向虚拟环境，请确认该环境下的python.exe能正常处理UTF-8路径（建议用venv而非conda）
Git中文路径显示八进制转义需关quotepath
这跟VSCode无关，是Git自身在Windows下的默认行为。\344\270\255\346\226\207这类输出说明Git把中文路径转成了八进制转义，VSCode只是原样展示。
- 终端执行：
git config --global core.quotepath false - 可选加：
git config --global core.precomposeunicode true（对macOS必要，Windows影响小） - 重启VSCode或其集成终端，源代码管理面板里的文件名才会变正常
- 注意：此配置只影响路径显示，不影响文件内容编码；若文件本身是GBK，仍需按文件编码方案处理
最易被忽略的是：系统区域设置改完必须重启，且code .比code "C:\项目\main.py"可靠得多——前者由VSCode自己做路径映射，后者依赖Shell参数转义，而PowerShell/CMD对中文路径的转义规则根本不一致。
