vscode中文路径报错本质是编码链断裂：python解释器、终端、launch.json三者对路径字符串解码方式不一致；需在launch.json中配置"pythonioencoding":"utf-8"、"pythonutf8":"1"及"pythonpath"，并确保code runner启用runinterminal及正确转义路径变量。
中文路径本身不会让 VSCode 编译失败，真正崩的是编码链——Python 解释器、终端、launch.json 三者对路径字符串的解码方式不一致。
为什么 launch.json 里 ${file} 一碰就报 FileNotFoundError
VSCode 内部把 ${file} 路径转成 UTF-8 字节串传给 Python 进程，但 Windows 上默认的 python.exe 从系统继承 CP936（GBK）编码，拿到 UTF-8 字节却用 GBK 去 decode，自然炸开。错误常表现为：FileNotFoundError: [Errno 2] No such file or directory 或卡在调试启动阶段无响应。
- 别改系统区域设置里的“Beta: 使用 Unicode UTF-8”，它只影响新 cmd 窗口，不影响 VSCode 启动的子进程
- 必须在
.vscode/launch.json的env块中显式声明编码意图 - 至少加这三项：
PYTHONIOENCODING（标准 I/O）、PYTHONUTF8（强制解释器用 UTF-8 模式）、PYTHONPATH（避免相对导入二次解析路径）
Code Runner 插件运行 C++/Python 时中文路径闪退或乱码
Code Runner 默认用 shell 执行命令，但它的 executorMap 不自动处理路径编码，且 Windows 下 cmd 默认是 GBK，g++ 或 python 收到的参数仍是乱码字节。
- 打开设置 → 搜索
code-runner.runInTerminal→ 设为true：让命令真正在集成终端里跑，继承终端当前编码 - 修改
code-runner.executorMap中对应语言的命令，把路径变量换成带引号的完整形式，例如："python -u \"${file}\""（注意双引号转义） - 对 C++，确保
tasks.json中args里的${file}没被额外拼接引号包裹，否则 g++ 会把带引号的路径当字面量处理
终端能跑，但 F5 调试或 Run Code 就失败
这是最典型的环境错位：你在终端手动激活了 venv，终端里 which python 指向虚拟环境；但 VSCode 的调试器或 Code Runner 并未读取该环境，仍调用系统 Python，而系统 Python 根本没装你依赖的包，甚至路径都解析不了。
- 右下角点击 Python 版本号，确认显示的路径和你在终端执行
pip show requests时用的pip属于同一环境 - 如果用了 venv，不要只靠
source venv/bin/activate，还要在 VSCode 中按Ctrl+Shift+P→Python: Select Interpreter，手动选中venv/bin/python（macOS/Linux）或venv\Scripts\python.exe（Windows） - 关闭所有 VSCode 窗口，从已激活 venv 的终端中执行
code .启动，确保环境变量完整继承
真正棘手的不是“路径含中文”，而是不同组件间对同一个字符串的编码预期不一致。哪怕只漏掉 PYTHONUTF8 这一项，sys.getfilesystemencoding() 依然返回 mbcs，路径就还是解不开。动手前先看一眼终端里 chcp 输出和 Python 里 sys.getdefaultencoding() 的值，比盲目改路径更省时间。
