如何处理Git中跨Windows、Unix系统的文件名大小写敏感问题

一、最优解决方案 #

1. 存量冲突文件清理 #

• 优先在大小写敏感的Unix环境或Windows WSL环境中操作，避免Windows本地自动覆盖文件导致内容丢失
• 盘点所有仅大小写不同的重复文件，合并冗余内容、删除无效文件，统一所有文件的命名规则，彻底消除仅靠大小写区分的同名文件
• 提交清理结果：执行git add .后提交，提交说明标注「统一文件名大小写，修复跨系统冲突」后推送到远程仓库

2. Git规则配置 #

• 所有Windows端本地开发环境执行全局配置命令：git config --global core.ignorecase false，强制Git检测文件名大小写变化，避免后续提交时自动忽略大小写差异生成冲突文件
• 若项目确实需要保留大小写不同的文件名，可在Windows端给本地项目目录开启大小写敏感权限，执行命令：fsutil file setCaseSensitiveInfo 你的项目目录路径 enable，避免本地文件被覆盖
• 在仓库根目录新增.gitconfig文件提交到远程，配置如下内容，所有成员拉取后自动应用仓库级规则：

[core]
ignorecase = false

3. 前置校验拦截 #

• 在仓库的CI流水线中新增文件名大小写校验步骤，只要检测到新提交的文件名和已有文件仅大小写不同，直接拦截合并请求，从源头避免冲突内容进入主分支

二、行业通用规范 #

跨操作系统协作的Git项目普遍遵循以下命名规范，从根源避免大小写冲突问题：

• 全小写+分隔符命名是业内公认的最优实践：所有文件名统一使用全小写格式，单词之间用下划线（_）或者短横线（-）分隔，禁止使用大小写混合的驼峰格式命名文件
• 特殊场景（如Java项目类名与文件名对齐需用大驼峰）要求全团队统一命名规则，同一个语义的文件名只能有一种大小写写法，不允许出现多个变体
• 禁止仅通过修改文件名大小写来区分不同功能的文件，功能差异需要通过文件名前缀、后缀或者目录结构来体现

内容的提问来源于stack exchange，提问作者Vandit Goel