VSCode 终端对非 ASCII 文件名在运行命令参数中的编码兼容性修复-VSCode-PHP中文网

根本原因是中文路径在进程间传递时编码错位：终端以gbk传参，python却用utf-8解码，导致路径解析失败；需统一终端代码页（如powershell设chcp 65001）、正确配置lang环境变量并彻底重启vscode验证生效。

vscode 终端对非 ascii 文件名在运行命令参数中的编码兼容性修复

为什么 `ls` 或 `python` 传中文路径会报错或找不到文件

根本原因不是 VSCode 终端“显示乱码”，而是它把中文文件名按错误编码传给了底层命令。比如你在终端里执行 python 脚本.py，但 shell 实际收到的字节流是 GBK 编码的 \xc4\xe3，而 Python 解释器默认用 UTF-8 解码参数，自然解析失败——报错可能是 No such file or directory，也可能是 SyntaxError: Non-ASCII character '\xe5'（这个 \xe5 就是 UTF-8 中文“你”的首字节，说明 Python 误以为源码是 UTF-8，但实际被当成了 Latin-1 或其他单字节编码读入）。

Windows 上 PowerShell 终端必须设 `chcp 65001` 启动参数

PowerShell 默认代码页是 936（GBK），但它又允许脚本输出 UTF-8，这种混合模式会让文件名参数在进程间传递时失真。只改 terminal.integrated.env.windows 加 LANG 没用，因为 Windows 不认这个变量。

打开 VSCode settings.json，添加或修改：

"terminal.integrated.profiles.windows": {
  "PowerShell": {
    "source": "PowerShell",
    "args": ["-NoExit", "-Command", "chcp 65001 > $null"]
  }
}

terminal.integrated.defaultProfile.windows 必须设为 "PowerShell"，不能是 Command Prompt 或 Git Bash（后者需另配 LANG）
改完后必须彻底关闭 VSCode 再重开——旧终端进程不会自动 reload code page
验证：新开终端后运行 chcp，输出应为 活动代码页: 65001；再运行 [Console]::OutputEncoding，返回值应含 UTF8Encoding

macOS/Linux 下 `LANG` 不生效？检查 shell 启动文件是否被跳过

VSCode 从 Dock 或桌面图标启动时，不会加载 ~/.zshrc 或 ~/.bashrc，导致 LANG 保持系统默认的 C，进而让 git、python 等工具拒绝处理中文路径。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

先在系统终端里运行 locale，确认 LANG 是类似 zh_CN.UTF-8 或 en_US.UTF-8 的值
在 VSCode 设置中搜 terminal.integrated.env → 点「在 settings.json 中编辑」

添加对应平台配置：

"terminal.integrated.env.osx": {
  "LANG": "zh_CN.UTF-8"
}

或

"terminal.integrated.env.linux": {
  "LANG": "en_US.UTF-8"
}

切勿设置 LC_ALL：它会强制覆盖所有 locale 子项，可能让 less、man 等工具行为异常

Git Bash 终端里中文路径仍报错？关键在 `LANG` 和 `LC_ALL` 是否为空

Git Bash 本身支持 UTF-8，但它的 Unicode 模式开关取决于环境变量。只要 LANG 或 LC_ALL 是空值或 C，它就退回到 ASCII 模式，直接拒绝中文路径和文件名——报错类似 fatal: not a git repository (or any of the parent directories)，哪怕路径明明存在。

在 VSCode settings.json 中配置：

"terminal.integrated.env.windows": {
  "LANG": "zh_CN.UTF-8",
  "LC_ALL": ""
}

LC_ALL 设为空字符串（不是删掉，也不是设成 "" 字面量），这是 Git Bash 的特殊要求：清空该变量才能让它尊重 LANG
不要依赖 terminal.integrated.shellArgs.windows 传 export 命令——Git Bash 启动时已读取完环境，后期 export 无效
验证：新开 Git Bash 终端后运行 echo $LANG 和 ls 中文.txt