场景介绍

在一个团队中，成员可能使用不同的操作系统进行开发。例如，Windows 用户的文件系统对文件名不区分大小写，而 Linux 用户的文件系统则是区分大小写的。这种差异可能导致以下问题：

• 文件冲突：同一目录下存在 README.md 和 readme.md，在大小写不敏感的系统上会被视为同一个文件，导致版本控制中的混乱。
• 部署问题：某些文件在大小写敏感的服务器上可能找不到，从而导致应用程序运行错误。
• 代码引用错误：代码中引用的文件名大小写不一致，可能在某些环境下无法正确加载资源。

为了避免这些问题，确保 Git 能够追踪文件名的大小写变化是至关重要的。

方案概述

Git 提供了一个配置选项 core.ignorecase，用于控制文件名的大小写敏感性。默认情况下，该选项会根据操作系统的文件系统自动设置：

• 在大小写不敏感的文件系统上（如 Windows 和 macOS），core.ignorecase 默认为 true。
• 在大小写敏感的文件系统上（如大多数 Linux 文件系统），core.ignorecase 默认为 false。

要在 Git 中开启文件名的大小写敏感追踪，需要将 core.ignorecase 设置为 false。这样，Git 会区分文件名的大小写变化，确保在版本控制中准确追踪文件的重命名和修改。

原理解析

core.ignorecase 的作用

• core.ignorecase = true：Git 将忽略文件名的大小写变化。例如，README.md 和 readme.md 被视为同一个文件。这在大小写不敏感的操作系统上有助于避免不必要的文件冲突。

• core.ignorecase = false：Git 将区分文件名的大小写变化。README.md 和 readme.md 被视为不同的文件。这在大小写敏感的文件系统上确保了文件名的唯一性和准确性。

为什么需要手动设置

尽管 Git 会根据操作系统默认设置 core.ignorecase，但在某些情况下，你可能需要手动调整。例如：

• 在大小写不敏感的系统上开发，但需要部署到大小写敏感的服务器。
• 遇到文件名大小写冲突但不容易解决的情况。

手动设置 core.ignorecase 为 false 可以强制 Git 开启大小写敏感追踪，确保版本库的准确性。

使用示例

1. 查看当前配置

在修改配置之前，建议先查看当前 core.ignorecase 的设置：

bash
git config core.ignorecase

2. 设置 core.ignorecase 为 false

在 Git 仓库中执行以下命令，将 core.ignorecase 设置为 false：

bash
git config core.ignorecase false

如果你希望全局应用此设置（对所有仓库生效），可以添加 --global 选项：

bash
git config --global core.ignorecase false

3. 验证配置

再次查看配置，确保设置已生效：

bash
git config core.ignorecase
# 输出应为: false

4. 重命名文件以测试大小写敏感性

假设当前仓库中有一个文件 example.txt，我们将其重命名为 Example.txt：

bash
git mv example.txt Example.txt
git commit -m "Rename example.txt to Example.txt to test case sensitivity"

由于 core.ignorecase 被设置为 false，Git 会将 example.txt 和 Example.txt 视为不同的文件，并正确跟踪重命名操作。

5. 处理现有的大小写冲突

如果你的仓库中已经存在大小写冲突的文件，可以按照以下步骤解决：

1. 暂存所有更改：

   bash
   git add .
   

2. 提交或暂存当前更改。

3. 设置 core.ignorecase 为 false。

   bash
   git config core.ignorecase false
   

4. 重命名其中一个文件，确保文件名的大小写有变化。

   bash
   git mv conflictingFile.txt ConflictingFile.txt
   git commit -m "Resolve case sensitivity conflicts"
   

参考资料

• Git 官方文档 - core.ignorecase