如何让.git目录大小写兼容 实现跨Linux/Mac/Windows仓库同步
2026-10-10
跨平台Git仓库大小写兼容解决方案
问题根因
Linux默认文件系统区分文件名大小写，而Mac（默认APFS配置）、Windows（默认NTFS配置）均不区分大小写，Git内部引用文件在大小写敏感的Linux系统生成仅大小写不同的文件后，同步到另外两个系统就会出现覆盖、识别异常等问题，你遇到的重复分支日志文件就是典型表现。
前置全局配置（所有设备均需设置，优先在Linux主力设备完成）
- 开启Git大小写严格检查：
git config --global core.ignorecase false
该配置会强制Git识别文件名大小写差异，既避免在不区分大小写的系统上误提交大小写不同的同名仓库文件，也会阻止Git内部生成仅大小写不同的引用、日志文件。 - 统一分支/标签命名规则：所有本地、远程分支和标签统一使用固定大小写规范，建议优先采用全小写加短横线的命名方式，从源头避免出现仅大小写不同的同名引用。如果是团队协作仓库，需同步所有成员遵守该规则。
已有异常清理（仅在Linux主力设备操作）
- 先查询所有存在的重复引用：
git show-ref，筛选出大小写不同的重复分支、标签 - 删除不符合命名规范的远程引用，例如删除大写的TICKET-123-fix-this-thing远程分支：
git push origin --delete TICKET-123-fix-this-thing - 清理本地残留异常文件：执行
git gc --prune=now清理无效引用，再手动删除.git/logs/refs/remotes/origin/目录下不符合命名规范的重复日志文件即可。
跨平台同步规范
- 不要直接复制整个
.git目录跨系统传输，优先使用git pull/git push走Git原生协议同步，Git的传输逻辑会自动处理引用的大小写一致性，不会生成重复文件。 - 确需直接拷贝完整仓库时，拷贝前先在Linux端执行
git fsck检查.git目录完整性，确认无重复引用后再拷贝，拷贝到Mac/Windows后首次操作前执行git reset --hard HEAD重置本地引用，避免异常。 - 非必要不建议修改Mac/Windows系统全局的文件系统大小写规则，容易导致普通第三方应用运行异常，确有需要可以单独为Git仓库创建一个区分大小写的独立分区/卷宗。
常规校验
每次从Linux端推送变更到远程仓库前，执行git ls-remote origin检查所有远程引用的大小写是否统一，确认无重复后再同步到Mac/Windows设备，避免把异常引用带入其他设备。
内容的提问来源于stack exchange，提问作者Marian
相关产品推荐
相关产品推荐
