Mac Git 系统常见技术问题：如何解决 Git 在 macOS 上的中文乱码问题？

Question

在使用 Git 进行版本控制时，macOS 用户常常遇到中文文件名或提交信息显示为乱码的问题。该问题通常出现在终端显示、Git 日志（git log）或图形界面工具中，表现为“\346\227\245\346\234\255”等转义字符形式的乱码。造成此现象的主要原因在于 Git 默认使用的编码方式与 macOS 系统编码不一致，或者终端环境未正确配置 UTF-8 支持。解决该问题需从 Git 配置、系统环境变量及终端模拟器设置三方面入手，确保各环节统一采用 UTF-8 编码标准，以实现中文字符的正常显示与处理。

Answer 1

一、问题背景与现象描述

在 macOS 系统上使用 Git 进行版本控制时，开发者常常遇到中文文件名或提交信息显示为乱码的问题。典型表现为：

• 终端中执行 git log 时出现类似 346227245346234255 的转义字符；
• 图形界面工具（如 Sourcetree、VS Code）中中文文件名显示异常；
• git status 输出的文件名显示为“?\347\224\265\346\200\241?”等格式。

这类问题通常源于 Git 编码配置与系统环境不一致，或者终端未正确支持 UTF-8 字符集。

二、原因分析

从技术角度深入剖析，该问题主要涉及以下三个层面：

1. Git 默认编码配置问题：Git 在处理路径和日志信息时，默认使用系统区域设置（locale），而某些 macOS 版本可能未默认启用 UTF-8。
2. 终端模拟器编码设置缺失：如 iTerm2 或 Terminal.app 若未显式设置字符集为 UTF-8，则可能导致输出乱码。
3. 环境变量配置不当：macOS 中若未正确设置 LANG 和 LC_ALL 环境变量，将影响 Git 对中文字符的解析。

三、解决方案详解

为了彻底解决此问题，需从 Git 配置、终端设置和系统环境变量三方面进行统一调整。

3.1 Git 配置修改

通过设置 Git 的 i18n 相关参数，确保其使用 UTF-8 编码处理路径和日志。

git config --global i18n.commitEncoding utf-8
git config --global i18n.logOutputEncoding utf-8
  

3.2 终端模拟器设置

以 iTerm2 为例，确保终端使用的字符集为 UTF-8：

设置项	配置值
Character Encoding	UTF-8
Environment Variables	添加 LANG=en_US.UTF-8

3.3 系统环境变量配置

编辑 shell 配置文件（如 .zshrc 或 .bash_profile），添加如下内容：

export LANG=en_US.UTF-8
export LC_ALL=en_US.UTF-8
  

保存后运行 source ~/.zshrc（或对应 shell 文件）使配置生效。

四、验证方法

完成上述配置后，可通过以下命令验证是否已解决乱码问题：

• git log --pretty=format:"%s"：查看提交信息是否正常显示中文；
• git status：确认中文文件名不再显示为乱码；
• 图形界面工具刷新仓库视图，观察中文内容是否正常。

五、流程图总结

graph TD
      A[开始] --> B{是否存在中文乱码}
      B -- 是 --> C[检查 Git 编码配置]
      C --> D[设置 i18n 参数为 UTF-8]
      B -- 否 --> E[无需更改]
      D --> F[检查终端编码设置]
      F --> G[设为 UTF-8 并配置环境变量]
      G --> H[完成配置]
      H --> I[验证 git log 和 status 显示]