如何确保Git仓库层面强制区分大小写，不受用户配置或系统影响？

背景 #

.NET MAUI对文件名有严格要求：必须全小写、首尾为字母、仅包含字母数字或下划线。从Xamarin升级到MAUI时，需要批量修改现有文件名以适配该规则。但团队使用Windows系统时，Git for Windows默认启用大小写不敏感配置，导致文件名大小写修改在不同开发者机器上出现异常：本地设置core.ignorecase false能识别重命名，但其他用户配置为true时，Git无法区分大小写变化，提交后在不同机器表现不一致。

核心问题解决方案 #

Git本身没有内置的全局强制仓库大小写敏感的机制（core.ignorecase是本地级配置，无法通过仓库直接同步给所有用户），但可以通过以下几种方式确保团队内大小写处理的一致性：

1. 仓库初始化脚本统一配置 #

创建仓库级的初始化脚本，让所有开发者克隆仓库后执行一次，统一设置本地仓库的大小写敏感配置：

• Windows下创建setup.cmd：

@echo off
git config core.ignorecase false
git config core.fscache false
echo 已设置仓库为大小写敏感模式

• Linux/macOS下创建setup.sh：

#!/bin/bash
git config core.ignorecase false
echo 已设置仓库为大小写敏感模式

将这两个脚本提交到仓库根目录，要求团队成员克隆后运行对应脚本，确保本地配置一致。

2. 使用git mv规范文件名修改 #

所有文件名大小写调整必须通过git mv命令执行，例如：

git mv OldViewModel.cs old_view_model.cs

这样Git会正确记录文件重命名操作，而非标记为“删除旧文件+添加新文件”。即便部分用户未修改core.ignorecase，只要仓库中已存在正确的小写文件名，拉取后Git会自动同步正确的文件状态。

3. 预提交钩子强制文件名合规 #

编写预提交钩子脚本，检查待提交文件的命名是否符合.NET MAUI要求，不符合则阻止提交。在仓库的.git/hooks目录下创建pre-commit文件（无后缀），内容示例：

#!/bin/bash
# 检查文件名是否符合.NET MAUI要求：小写、首尾字母、仅含字母数字下划线
invalid_files=$(git diff --cached --name-only | grep -vE '^[a-z][a-z0-9_]*[a-z]$')
if [ -n "$invalid_files" ]; then
    echo "以下文件名不符合.NET MAUI要求（需全小写、首尾为字母、仅含字母数字下划线）："
    echo "$invalid_files"
    exit 1
fi

将该脚本提交到仓库（可创建hooks目录存放，让开发者复制到.git/hooks目录），从根源上避免不符合规则的文件名进入仓库。

总结 #

虽然无法通过Git内置机制直接强制所有用户的仓库大小写敏感，但通过统一初始化配置、规范重命名操作、添加钩子检查这三个步骤，能有效解决跨机器的文件名大小写不一致问题，适配.NET MAUI的命名要求。

内容的提问来源于stack exchange，提问作者Josh Brunton