mac终端中文乱码或显示方块的核心原因是编码未设为utf-8和字体不支持中文,需四步解决:一、在~/.zshrc中导出lang="en_us.utf-8"和lc_all="en_us.utf-8"并source生效;二、配置git全局编码参数,尤其core.quotepath false;三、终端字体改用pingfang sc/tc或meslolgs nf;四、ssh会话需本地sendenv与远程acceptenv协同设置。
mac终端中文乱码或显示方块字符,核心原因就两个:编码没设对、字体不支持中文或特殊符号。zsh本身没问题,问题出在环境配置和渲染层。下面分四步直接解决,每步都对应一种典型现象。
一、确认并强制启用UTF-8编码
即使系统默认是UTF-8,zsh启动时也可能因配置缺失回退到C locale,导致中文路径、git log、ls结果全变问号或方块。
- 在终端中运行:echo $LANG 和 echo $LC_ALL,如果输出为空、C 或 en_US.ISO8859-1,说明编码未生效
- 编辑 ~/.zshrc:nano ~/.zshrc
- 在文件末尾添加(注意带英文双引号):
export LANG="en_US.UTF-8"
export LC_ALL="en_US.UTF-8"
(推荐用 en_US.UTF-8 而非 zh_CN.UTF-8,兼容性更好,且不影响中文显示) - 保存后执行:source ~/.zshrc
二、为Git单独设置中文编码
git命令(如 git status、git log)的中文乱码常独立于系统locale,需额外配置。
- 运行以下四条命令一次性配齐:
git config --global core.quotepath false
git config --global gui.encoding utf-8
git config --global i18n.commit.encoding utf-8
git config --global i18n.logoutputencoding utf-8 - 其中 core.quotepath false 最关键——它让 git 不对中文路径加反斜杠转义,否则 ls 看着正常,git status 却显示成 "\344\270\255\346\226\207" 这类八进制乱码
三、换用真正支持中文的等宽字体
编码正确但还显示方块?那是字体缺字形。Menlo、Courier New、SF Mono 都不包含完整中文字体,必须手动切换。
- 打开“终端”→“偏好设置”→选中当前配置文件(如 Pro)→“文本”标签页
- 点击“字体”右侧的“更改…”按钮
- 选择系统自带的 PingFang SC(简体中文)或 PingFang TC(繁体),它们是苹果专为中文优化的等宽字体,无需安装
- 若你用了 Oh My Zsh 或 Powerlevel10k 类主题,且看到箭头、分支符号变成方块,则必须换 MesloLGS NF 这类 Nerd Font(从 Powerlevel10k 官方页面 下载安装)
四、检查SSH或远程会话是否传递了本地环境
用 SecureCRT、VSCode Remote 或 ssh 连其他机器时,中文乱码大概率是因为远程端没收到你的 LANG 设置。
- 确保本地 ~/.zshrc 中已设好 LANG 和 LC_ALL(见第一步)
- 在远程服务器的 ~/.zshrc 或 ~/.profile 里也加上相同两行导出语句
- 若用 ssh,可在本地 ~/.ssh/config 中为该主机添加:
SendEnv LANG LC_*
SetEnv LANG=en_US.UTF-8 - 同时确认远程服务器 SSH daemon 允许接收环境变量:检查 /etc/ssh/sshd_config 是否有 AcceptEnv LANG LC_*,没有就加上并重启 sshd











