vscode插件调用中文路径报错根源是编码链断裂：python插件启动时子进程继承cp936编码，而vscode传入utf-8路径uri，导致filenotfounderror等错误；须在launch.json中同时配置"pythonioencoding":"utf-8"和"pythonutf8":"1"，并避免tasks.json中路径拼接引号陷阱。
VSCode插件调用时中文路径报错的根源
不是插件本身不支持中文，而是插件进程继承了宿主环境的编码上下文——比如 Python 插件启动 python.exe 时，Windows 默认以 CP936（GBK）解析路径，而 VSCode 传入的是 UTF-8 编码的 URI，两边对不上就炸。常见报错包括 FileNotFoundError、UnicodeDecodeError，或调试器卡在 launch 阶段无响应。
launch.json 中必须加的两个环境变量
仅改界面语言没用，插件执行环境需显式声明 UTF-8。在项目根目录的 .vscode/launch.json 中，于 configurations 下对应配置里添加：
{
"env": {
"PYTHONIOENCODING": "utf-8",
"PYTHONUTF8": "1"
}
}
-
PYTHONIOENCODING强制 Python 标准输入输出用 UTF-8 -
PYTHONUTF8=1是 Python 3.7+ 的开关，让解释器全程用 UTF-8 处理文件系统路径 - 这两个变量必须同时存在，缺一不可；只设一个仍可能在某些插件（如 Pylance 启动分析器）中失效
tasks.json 里拼路径别加引号陷阱
写构建任务时，如果手动拼接含中文的路径，"${file}" 或 "${workspaceFolder}" 本身已带 UTF-8 编码，再套一层双引号会导致 Windows cmd 解析失败。例如：
// ❌ 错误写法（引号引发转义）
"args": ["python", "${file}"]
// ✅ 正确写法（去掉外层引号，让 shell 直接接收原始字符串）
"args": ["python", "${file}"]
- PowerShell 和 CMD 对带空格/中文路径的引号处理逻辑不同，统一用无引号形式最稳
- 若必须用引号（如参数含空格），改用 PowerShell 脚本封装，并在脚本开头加
[Console]::OutputEncoding = [Text.Encoding]::UTF8 - 避免在
tasks.json中用+拼接字符串，改用command+args结构
Remote-SSH / WSL 下要单独配 locale.json
本地设好了 locale.json，远程连上去还是英文？因为 Remote-SSH 和 WSL 各自有一套用户数据目录，语言设置不继承。必须分别操作：
- Remote-SSH：连接后按
Ctrl+Shift+P→ 运行Developer: Open User Data Folder→ 进入User目录，新建或编辑locale.json，内容为{"locale":"zh-cn"} - WSL：在终端运行
code --list-extensions确认 Server 已启；然后进~/.vscode-server/data/Machine/（路径含哈希后缀）→User/locale.json - 注意：Remote 端的语言包也要单独安装，
Chinese (Simplified) Language Pack插件不会自动同步
真正麻烦的不是设语言，而是让每一个子进程（Python、Git、Shell、插件后台服务）都拿到一致的 UTF-8 上下文——漏掉任意一环，中文路径就可能在某个环节突然变问号或报错。
