必须在launch.json的env中配置"pythonioencoding":"utf-8"和"pythonutf8":"1"，因vscode传递的utf-8路径被windows默认cp936解码导致中文路径失败，需绑定到单个调试配置且仅python 3.7+支持。
launch.json 里必须加 PYTHONIOENCODING 和 PYTHONUTF8
调试中文路径文件失败，90% 是因为 Python 子进程没被告知该用 UTF-8 解码路径。VSCode 把 ${file} 这类变量传过去时是 UTF-8 字节流，但 Windows 上默认的 python.exe 会用 CP936（GBK）去 decode —— 结果就是路径被截断或解析成乱码。
实操建议：
- 在
.vscode/launch.json的具体 configuration 的env对象里，明确写入："PYTHONIOENCODING": "utf-8""PYTHONUTF8": "1"（仅 Python 3.7+ 支持）"PYTHONPATH": "${workspaceFolder}" - 不要塞进全局
env或系统环境变量，必须绑定到单个 launch 配置 - 如果用的是
debugpy或自定义 launcher，确认其版本支持PYTHONUTF8，旧版 debugpy（
tasks.json 中路径拼接必须用正斜杠 + 单项数组
Windows 下 CommandLineToArgvW 在 GBK 代码页下，会把 C:项目main.cpp 里的反斜杠+中文误判为非法转义序列，直接丢弃后续参数，导致编译器报 “no input files”。
实操建议：
- 所有路径变量统一用正斜杠：
"${fileDirname}/${fileBasename}"，而非"${fileDirname}\${fileBasename}" - 每个参数单独占
args数组一项：["g++", "${file}", "-o", "out.exe"]✅
不要合并成字符串：["g++ "${file}" -o out.exe"]❌ - 避免路径中出现全角空格、中文括号、顿号——这些比汉字更容易触发截断
Git 集成显示 中文 而不是“中文”
这不是 VSCode 的 bug，是 Git 自身对路径做了八进制转义。VSCode 拿到的是转义后字符串，再解码就崩了。
实操建议：
- 执行
git config --global core.quotepath false关闭路径转义 - 顺手加
git config --global core.precomposeunicode true（Windows 建议，macOS 必需） - 重启 VSCode 或至少重启集成终端，否则源代码管理面板不会刷新
- 注意：该设置只影响路径显示，不影响文件内容编码；若文件内容本身是 GBK，仍需单独处理
插件兼容性要逐个验证，别信“已适配”宣传
很多插件（如 GitLens、C/C++、Remote-SSH）在中文路径下会静默失效：GitLens 找不到仓库根、C/C++ 插件无法解析 include 路径、Remote-SSH 连接后工作区路径变空。它们不报错，只是功能降级。
实操建议：
- 卸载所有非核心插件，仅保留官方 Python、Git 等基础插件，确认中文路径能跑通
- 逐个启用插件，每次启用后测试对应功能（如开一个含中文路径的 Git 仓库测 GitLens）
- 禁用符号链接方案（
mklink），Windows GUI 应用对软链支持极差，多数插件直接跳过解析 - 留意插件文档是否明确写了 “Windows + Chinese path support”，没写等于没支持
