VSCode中文路径报错本质是编码链断裂：文件系统、Python解释器、终端、VSCode四者编码不一致；需在launch.json中配置"PYTHONIOENCODING":"utf-8"和"PYTHONUTF8":"1"，并避免tasks.json中路径拼接引号陷阱。
VSCode 里中文路径报错，本质不是“路径不能有中文”，而是环境编码链断裂：文件系统、Python 解释器、终端进程、VSCode 自身四者编码视角不一致，一碰就崩。
为什么中文路径在 Python 调试时直接报错
错误现象常为 FileNotFoundError、UnicodeDecodeError 或调试器卡在 launch 阶段无响应。这不是 VSCode 拒绝中文路径，而是它调用 Python 进程时，子进程（如 python.exe）从 Windows 环境继承了 CP936（GBK）编码，却试图解析 UTF-8 编码的路径字符串——两边对不上。
- Windows 默认区域设置下，
sys.getfilesystemencoding()返回mbcs（即 GBK），但 VSCode 传入的路径 URI 是 UTF-8 编码的 -
launch.json中的${file}、${fileDirname}变量值在内部已 UTF-8 编码，但未显式告知 Python 子进程该用什么编码去 decode 它 - 即使脚本开头写了
# -*- coding: utf-8 -*-，也只影响源码解析，不影响路径参数传递过程
launch.json 必加的三行环境配置
仅靠改系统区域或关掉“Beta: 使用 Unicode UTF-8”治标不治本；真正起效的是让 Python 进程从启动那一刻就明确知道该用 UTF-8 处理 I/O 和路径。
- 在
.vscode/launch.json的配置项中加入"env"块，至少包含以下三项： -
"PYTHONIOENCODING": "utf-8"：强制标准输入输出使用 UTF-8 -
"PYTHONUTF8": "1"：启用 Python 3.7+ 内置的 UTF-8 模式（绕过系统 locale） -
"PYTHONPATH": "${workspaceFolder}"（可选但推荐）：避免因相对导入失败引发的二次路径解析
示例片段：
{
"version": "0.2.0",
"configurations": [
{
"name": "Python: Current File",
"type": "python",
"request": "launch",
"module": "pytest",
"console": "integratedTerminal",
"cwd": "${fileDirname}",
"env": {
"PYTHONIOENCODING": "utf-8",
"PYTHONUTF8": "1"
}
}
]
}tasks.json 和终端命令中的路径引号陷阱
当你在 tasks.json 里写 "command": "python ${file}"，VSCode 会把含中文的 ${file} 展开为类似 C:项目main.py 的字符串，然后丢给 PowerShell 执行——PowerShell 把反斜杠当转义符、把中文当乱码，最后实际执行的是 python C:项目main.py，自然找不到文件。
- 必须用数组形式传参：
"args": ["${file}"]，而非拼接进command字符串 - 确保
command指向明确路径，比如"command": "python"，不要写成"command": "C:\Users\张三\AppData\Local\Programs\Python\Python311\python.exe"（易出转义错误） - 如果非要用绝对路径，PowerShell 下必须双引号包裹且反斜杠双重转义：
"command": "C:\Users\张三\AppData\Local\Programs\Python\Python311\python.exe"→ 实际应写为"command": "C:\\Users\\张三\\AppData\\Local\\Programs\\Python\\Python311\\python.exe"
最易被忽略的底层冲突点
很多人修复了 launch.json 却仍失败，是因为没意识到：VSCode 启动 Python 进程时，还会读取 Windows 注册表中的 PythonCore 配置或 py.ini 文件。若这些地方设置了 EnableUTF8=0 或指定了旧版编码策略，会覆盖 PYTHONUTF8=1。
- 检查
%USERPROFILE%py.ini是否存在，若有，确认其中没有enableutf8=0 - 注册表路径
HKEY_CURRENT_USERSOFTWAREPythonPythonCore.11LaunchSettings下的EnableUTF8值应为1 - WSL 用户注意：
code命令若从 WSL 内启动，需确保wsl.conf中automount和interop开启，否则${file}展开的 Windows 路径无法被正确映射为 Linux 路径
