core.precomposeunicode仅适用于macos，用于解决apfs/hfs+的nfd归一化问题；linux/wsl无需且无效，应配合core.quotepath false、utf-8 locale及i18n相关配置实现跨平台中文路径正常显示。
core.precomposeunicode 主要用于 macOS，解决 APFS 文件系统中 UTF-8 的 NFD（Normalization Form D）归一化问题。Linux（包括 WSL）不使用该机制，设为 true 无实际作用，甚至可能干扰某些工具链。它不是跨平台通用的“中文乱码开关”，不能单独解决 macOS 与 Linux 之间的文件名显示差异。
macOS 必须开启：precomposeUnicode = true
macOS 默认用 NFD 存储 Unicode 字符（如“中文”会被拆成基础字符+组合符），而 Git 内部期望 NFC 形式。开启后，Git 自动将路径从 NFD 转为 NFC 再处理，避免文件名比较失败、状态误判或 diff 显示异常。
- 执行命令：
git config --global core.precomposeunicode true - 适用于所有基于 HFS+/APFS 的 macOS 环境
- 不影响 Linux 或 Windows，但也不冲突
Linux 不需要也不建议设 precomposeunicode
Linux 文件系统（ext4、XFS、Btrfs 等）原生以 NFC 或字节直存方式保存路径，Git 直接读取 UTF-8 字节流即可。强行设置 core.precomposeunicode true 不触发任何转换逻辑，Git 会静默忽略该配置。
- 在 Ubuntu/WSL 中运行该命令无效，无需执行
- 若已误设，可用
git config --global --unset core.precomposeunicode清除 - 真正影响 Linux 中文路径显示的是
core.quotepath和 locale
跨平台协同的关键其实是 quotepath + locale + commitEncoding
macOS 和 Linux 共享仓库时，文件名乱码多源于输出阶段被转义或终端解码失败，而非存储本身。三者需统一：
-
git config --global core.quotepath false：禁用路径转义，让中文文件名原样输出（macOS/Linux 都适用） -
git config --global i18n.commitencoding utf-8：确保提交信息按 UTF-8 解析 -
git config --global i18n.logoutputencoding utf-8：强制日志路径输出为 UTF-8 - Linux 终端必须启用 UTF-8 locale，例如
export LANG=en_US.UTF-8（WSL 中常需手动设置）
验证是否生效
创建含中文名的文件（如 测试.md），分别在 macOS 和 Linux 终端中运行：
-
git status—— 应直接显示测试.md，而非"\346\265\213\350\257\225.md" -
git diff --name-only—— 中文路径不带引号、不转义 -
git log --oneline --name-only -1—— 提交记录里路径可读
