VSCode中文路径报错本质是编码链断裂：Python解释器用GBK解码VSCode传来的UTF-8路径字节串，导致FileNotFoundError或调试卡死；须在launch.json中配置"PYTHONIOENCODING":"utf-8"、"PYTHONUTF8":"1"、"PYTHONPATH":"${workspaceFolder}"三项环境变量，并确保右下角选中的Python解释器与配置一致。
VSCode 中文路径报错，不是路径本身违法，而是 Python 进程启动时用 GBK（CP936）去 decode 了 VSCode 传来的 UTF-8 路径字节串——两边编码视角错位，FileNotFoundError 或调试卡死是必然结果。
launch.json 必配的三项环境变量
VSCode 的 launch.json 是调试路径编码链的“总闸门”。不加这三项，改系统区域、换终端、重装 Python 都白搭：
-
PYTHONIOENCODING: 强制标准输入输出走 UTF-8，避免print("中文")在调试控制台变问号 -
PYTHONUTF8: 启用 Python 3.7+ 内置 UTF-8 模式，绕过 Windows 系统 locale，让open()、os.path等直接按 UTF-8 解析路径参数 -
PYTHONPATH: 设为"${workspaceFolder}"，防止相对导入触发二次路径拼接（比如from utils import helper时因路径解析失败又炸一次）
示例片段（放在 configurations 下对应配置的 env 字段内）：
"env": {
"PYTHONIOENCODING": "utf-8",
"PYTHONUTF8": "1",
"PYTHONPATH": "${workspaceFolder}"
}
Code Runner 插件运行中文路径脚本闪退
Code Runner 默认在 shell 中执行命令，但它的 executorMap 不自动转义路径变量，Windows 下 cmd 用 GBK 解析 "python -u ${file}" 里的 ${file}，结果就是乱码路径被传给 Python。
- 必须开启
code-runner.runInTerminal：让它真正在集成终端里跑，继承终端当前编码（配合terminal.integrated.env.windows设置更稳） - 修改
code-runner.executorMap中 Python 条目，把路径用双引号包裹并正确转义："python -u \"${file}\""（注意反斜杠转义） - 对 C++/g++，别在
tasks.json的args里手动加引号拼字符串；应让每个路径单独成数组项："args": ["-g", "${file}", "-o", "${fileDirname}/a.exe"]✅
为什么关掉“Beta: 使用 Unicode UTF-8”反而更稳
Windows 开启该选项后，Node.js 子进程会对 argv 中的中文路径做二次 UTF-8 编码，VSCode 收到的是乱码字节流，直接触发 Unable to resolve non-existing file。这不是 VSCode 的锅，是底层兼容性断层。
- 必须取消勾选「控制面板 → 区域 → 管理 → 更改系统区域设置」里的
Beta: 使用 Unicode UTF-8 - 重启电脑（仅改设置不重启无效），然后在 CMD 中运行
chcp，确认输出是活动代码页: 936 - 之后统一靠
launch.json和terminal.integrated.env.windows显式声明 UTF-8 意图，比依赖系统级开关更可控
tasks.json 里中文路径编译失败：斜杠和引号陷阱
MinGW/g++ 在 GBK 代码页下，会把 "C:\项目\main.cpp" 中的 \项 误判为非法转义序列，直接截断，报 no input files。
- 在
tasks.json的args中，一律用正斜杠："${fileDirname}/${fileBasename}"（VSCode 自动兼容 Windows） - 绝对不要把多个参数拼成一个字符串：
"-g \"${file}\" -o \"${fileDirname}/a.exe\""❌；要拆成独立数组项 ✅ - 路径变量本身不带引号，VSCode 传入时已处理；额外加引号反而会让 g++ 把引号当路径字面量的一部分
最易被忽略的一点：所有配置生效的前提是——你右下角选中的 Python 解释器，和 launch.json / code-runner 实际调用的是同一个可执行文件。点开右下角 Python 版本号，确认路径指向 venv 的 python.exe，而不是系统 Python；否则编码配置再全，也压根没加载进去。
