根本原因是中文路径在进程间传递时编码错位：终端以GBK传参，Python却用UTF-8解码，导致路径解析失败；需统一终端代码页（如PowerShell设chcp 65001）、正确配置LANG环境变量并彻底重启VSCode验证生效。
为什么 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 等工具拒绝处理中文路径。
- 先在系统终端里运行
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
真正卡住人的地方，往往不是“怎么设”，而是“设了为什么没生效”：VSCode 启动方式影响 shell 初始化流程，不同终端对环境变量的敏感度差异极大，而 LC_ALL 这种看似通用的变量，在 Git Bash 里反而要主动清空。每次改完都得关掉整个 VSCode，不是只关终端标签页。
