最典型表现是终端输出中文变问号或乱码（如文件）、脚本生成文本文件显示异常、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 配置中同样设置
