最典型表现是终端输出中文变问号或乱码（如文件）、脚本生成文本文件显示异常、git log或python -c "print('中文')" 输出异常；根源几乎总是lc_all、lang或lc_ctype未设为utf-8或被错误覆盖；可通过locale检查三者值，临时用export lc_all=en_us.utf-8验证，永久写入~/.zshrc或~/.bash_profile并source生效。

macos shell 环境变量中编码格式错误，最典型的表现是：终端输出中文变问号或乱码（如 文件），脚本生成的文本文件打开后显示异常，或 git log、python -c "print('中文')" 等命令输出异常。问题根源几乎总是环境变量 lc_all、lang 或 lc_ctype 未设为 utf-8，或被错误覆盖。

确认当前编码设置

在终端运行：

locale

重点看这三行输出：

• LANG=（主语言环境）
• LC_ALL=（最高优先级，会覆盖其他 LC_* 变量）
• LC_CTYPE=（控制字符分类和编码，直接影响终端显示）

如果其中任意一项值为空、是 C、POSIX，或类似 en_US.ISO8859-1 这样的非 UTF-8 值，就极可能引发乱码。

临时修复（立即生效，仅当前终端）

运行以下任一命令可快速验证是否为编码问题：

export LANG=en_US.UTF-8<br>export LC_ALL=en_US.UTF-8

再执行 locale 查看是否已更新；接着试 echo "测试中文"，若正常显示，说明问题定位准确。注意：LC_ALL 设定后会压制 LANG 和所有 LC_*，所以只需设它一个通常就够用。

永久生效（写入 Shell 配置文件）

先确认你当前用的是哪个 Shell：

macOS Automator Services

部署和使用军舰的 macOS Automator 自动化服务集合。包含 5 个实用工作流：PDF转JPG、PNG重命名并转JPG、图像拼接、解压RAR、顺序命名图像文件。一键安装所有服务到 ~/Library/Services/ 目录。使用场景：(1) "安装我的自动化服务"，(2) "部署所有 Automato...

下载

echo $SHELL

→ 若是 /bin/zsh（macOS Catalina 及以后默认），编辑 ~/.zshrc；
→ 若是 /bin/bash，编辑 ~/.bash_profile（注意不是 .bashrc，后者在 macOS 中默认不加载）。

在对应文件末尾添加：

export LANG=en_US.UTF-8<br>export LC_ALL=en_US.UTF-8

保存后执行：

source ~/.zshrc   # 或 source ~/.bash_profile

重启终端，再次运行 locale 确认生效。

避免常见陷阱

以下情况容易导致编码设置“看似写了却无效”：

• 在错误的配置文件里写入（比如 zsh 用户改了 .bash_profile）
• 配置文件中存在 unset LC_ALL 或 export LC_ALL=C 这类覆盖语句（尤其某些旧脚本或第三方工具会偷偷重置）
• VS Code / Cursor 终端未继承用户 Shell 环境：检查设置中 terminal.integrated.inheritEnv 是否为 true，并确保 VS Code 是从终端启动（code .）而非桌面图标直接打开
• 远程 SSH 登录时服务端未同步本地编码设置：需在远程机器的对应 Shell 配置中同样设置