Chromium 144 Windows 编译指南：Git 安装与配置

第 5 步（关键）：调整 PATH 环境变量

• 选择 "Git from the command line and also from 3rd-party software"
• 这样 Git 命令才能在任何命令行窗口中使用

第 6 步（关键）：HTTPS 传输后端

• 选择 "Use the native Windows Secure Channel library"
• 提供更好的 Windows 集成和性能

第 7 步（非常关键）：行尾转换设置

• 选择 "Checkout as-is, commit Unix-style line endings"
• 这正是 Chromium 所需的设置！它在检出代码时保持原样，提交时统一为 Unix 格式

第 8 步：终端模拟器

• 选择 "Use MinTTY (the default terminal of MSYS2)"
• 提供更好的终端体验和 Unicode 支持

第 9 步：其他选项

• 启用文件系统缓存：勾选（性能优化）
• 启用 Git 凭据管理器：勾选（便于存储凭据）
• 其他保持默认

完成后点击 "Install"，等待安装完成。

2.3 验证安装

安装完成后，打开新的命令提示符或 PowerShell 窗口（重要！需要重新打开才能加载新的 PATH），输入：

git --version

你应该看到类似的输出：

git version 2.52.0.windows.1

如果显示版本号，说明安装成功。若提示"git 不是内部或外部命令"，说明环境变量未生效，需要重启计算机或重新安装。

3 Chromium 专用 Git 配置

现在进入最关键的部分——为 Chromium 144 配置 Git。以下所有配置都使用 --global 标志，会对系统上的所有 Git 项目生效。如果只想对 Chromium 项目应用，可在克隆代码后，在项目目录中运行相同命令但去掉 --global 标志。

3.1 设置用户身份

git config --global user.name "Your Name"
git config --global user.email "[email protected]"

将 "Your Name" 替换为你的实际姓名，邮箱替换为你的邮件地址。

提示：如果计划向 Chromium 贡献代码，使用与 Google 账户关联的邮箱，这样你的贡献会被正确记录到开发者档案中。

3.2 启用长路径支持（Windows 特定）

git config --global core.longpaths true

这是 Windows 用户的必需配置。Windows 的 MAX_PATH 限制是 260 个字符，但 Chromium 的某些嵌套目录结构会导致路径超限。没有这个配置，克隆代码时会因路径过长而失败。

3.3 禁用自动换行符转换（跨平台协作的关键）

git config --global core.autocrlf false

这是最重要的配置之一。设置为 false 后，Git 将完全不转换换行符，保持源代码中的换行符原样。这确保无论你在 Windows、Mac 还是 Linux 上工作，源码的换行符都保持一致。

为什么不用其他值？

• true：会导致 CRLF 和 LF 混乱
• input：在某些场景下也不适合 Chromium

3.4 忽略文件权限变更

git config --global core.filemode false

Windows 和 Unix 处理文件权限的方式完全不同。启用此选项后，Git 将忽略文件权限的变化，避免因跨平台开发产生大量'虚假'的文件变更。

没有这个配置的后果：你在 Windows 改了一行代码，结果 Git 认为整个文件都变了（因为权限变了），这会污染代码历史。

3.5 分支自动 rebase（可选但推荐）

git config --global branch.autosetuprebase always

此配置使所有新创建的分支默认使用 rebase 而不是 merge 来集成上游改动。在 Chromium 这样的大型协作项目中，这有助于保持提交历史的线性，避免复杂的合并网络。

注意：如果你不熟悉 rebase，这个配置可能会让你困惑。可以先跳过，待学习后再启用。

3.6 提高性能的可选配置

git config --global core.preloadindex true

此配置在处理大型仓库（如 Chromium）时能显著提升性能，特别是在文件系统较慢的情况下。

4 验证配置

完成所有配置后，查看完整的配置列表：

git config --global --list

你应该看到类似的输出：

user.name=Your Name [email protected] core.longpaths=true core.autocrlf=false core.filemode=false branch.autosetuprebase=always core.preloadindex=true

如果所有配置都显示正确，说明 Git 现在已经为 Chromium 144 开发做好了准备。

5 常见问题排查

Q：能否查看单个配置的值？

git config --global core.autocrlf

输出会显示该配置的当前值。

Q：如何修改已有的配置？

使用相同的命令再次运行即可覆盖旧值：

git config --global user.name "New Name"

Q：如何删除某个配置？

git config --global --unset core.autocrlf

Q：配置保存在哪里？

所有全局配置保存在 ~/.gitconfig 文件中（即用户主目录）。你可以直接编辑这个文件，或通过命令行修改。

结语

你已经跨越了一个关键的里程碑。Git 的正确配置不仅仅是为了克隆代码，它关系到你接下来的整个开发流程。那些看似细节的配置选项——长路径支持、换行符处理、权限忽略——在实际工作中会帮你避开无数的坑。

当编译过程中出现诡异的错误时，很多人会花费数小时排查代码，却不知道根源可能只是一个未正确配置的 Git 设置。而现在，你已经拥有了一个'懂 Chromium 规则'的 Git 环境。