Windows Git 安装与配置全流程指南

✅ Git LFS (Large File Support)

• 解读：Git 原生擅长存储文本代码，处理大图片、视频效率低。LFS 是专门用于管理大文件的扩展插件，许多开源项目依赖它，建议勾选。

✅ Associate .git configuration files with default text editor

• 解读：将 .gitconfig 等配置文件关联到默认文本编辑器。勾选后双击文件即可直接编辑，无需系统询问用何软件打开。

✅ Associate .sh files to be run with Bash

• 解读：关联 Linux 脚本文件。勾选后在 Windows 上双击 .sh 文件可自动通过 Bash 运行，便于跨平台脚本执行。

⬜ Check daily for Git for Windows update

• 解读：不要勾选。Git 本身非常稳定，不需要每日检查更新。手动更新即可，避免弹窗打扰。

⬜ Add a Git Bash Profile to Windows Terminal

• 解读：看个人喜好。如果你使用的是 Win11 或安装了微软的 Windows Terminal，勾选后可在终端下拉菜单中看到 Git Bash；否则保持默认。

✅ Scalar

• 解读：微软开发的用于管理超大规模仓库的插件。个人项目虽用不上，但占用资源极少，保留作为未来扩展即可。

3. 开始菜单设置

• Start Menu Folder：保持默认的 "Git"。改名可能导致日后找不到入口。
• Don't create a Start Menu folder：不要勾选。保留开始菜单入口方便随时调用。

4. 默认编辑器 (Choosing the Editor) —— ⭐ 避坑重点

这一步决定 Git 需要输入提交信息时调用的软件。

• 默认选项 Vim：纯命令行古老编辑器，无鼠标操作，保存退出需记命令 (:wq)。新手极易卡死在这里。
• 推荐操作：务必在下拉菜单中选择其他选项。
  • 首选：Use Visual Studio Code as Git's default editor（若已安装 VS Code）。
  • 保底：Use Notepad as Git's default editor（记事本）。虽简陋但绝对安全，不会卡住。

5. 分支命名 (Branch Name)

• Let Git decide：默认主分支名为 master。这是旧标准。
• Override the default branch name：推荐选择。将默认分支名改为 main。
• 理由：GitHub、GitLab 等平台现在新建项目默认均为 main。本地统一设为 main 可避免推送时出现 master 与 main 双分支混乱的情况。

6. 环境变量 (PATH Environment)

决定在哪些地方可以输入 git 命令。

• Use Git from Git Bash only：太保守。仅在 Git Bash 可用，CMD 或 IDE 终端无法调用。
• Git from the command line and also from 3rd-party software：推荐选中。可在 CMD、PowerShell、IDE 终端中使用 Git，且不干扰系统自带命令。
• Use Git and optional Unix tools from the Command Prompt：千万别选。这会覆盖 Windows 自带的 find、sort 等命令，导致系统异常。

7. SSH 工具

• Use bundled OpenSSH：推荐。使用 Git 安装包自带的版本，开箱即用，稳定性高。
• Use external OpenSSH：高级选项。仅当你已在系统中手动配置好 OpenSSH 并希望共用密钥时才选。

8. HTTPS 传输后端

• Use OpenSSL library：推荐。Git 自带证书库，独立于 Windows 系统，不受公司策略或系统更新影响，连接更稳定。
• Use native Windows Secure Channel library：适用于大型公司环境，需使用内部根证书时选择。

9. 换行符转换 (Line Ending Conversion)

解决 Windows (CRLF) 与 Linux/macOS (LF) 的差异。

• Checkout Windows-style, commit Unix-style：推荐。检出时自动转为 Windows 格式防乱码，提交时自动转回 Unix 格式保仓库整洁。Windows 用户必选。
• Checkout as-is, commit Unix-style：检出不转换，可能导致老软件显示异常。
• Checkout as-is, commit as-is：完全不处理，易造成协作灾难。

10. 终端模拟器

• Use MinTTY：推荐。类 Linux 风格窗口，支持自由缩放、文字复制粘贴，体验远优于 Windows 默认控制台。
• Use Windows' default console window：老式黑底白字窗口，操作受限，不建议选择。

11. 拉取行为 (Pull Behavior)

• Fast-forward or merge：推荐。Git 经典模式。无冲突时快进，有冲突时创建合并提交，最安全直观。
• Rebase：高级技巧，会修改提交历史，新手慎用。
• Only ever fast-forward：严格模式，有分叉即报错，不适合日常开发。

12. 凭据助手 (Credential Helper)

• Git Credential Manager：强烈推荐。首次登录 GitHub/GitLab 后，它会加密保存凭证。后续 git push 时无需重复输入密码。
• None：每次推送都要求输入账号密码，体验极差。

13. 性能优化

• Enable file system caching：必须勾选。利用内存缓存文件系统数据，显著提升 Git 在 Windows NTFS 上的性能，避免 git status 卡顿。
• Enable symbolic links：默认不勾。符号链接在 Windows 上权限复杂，除非明确需要跨平台链接支持，否则保持默认。

三、验证与初始化

安装完成后，打开 CMD 或 PowerShell 验证版本：

git --version

若显示类似 git version 2.x.x.windows.1 的版本号，说明安装成功。

四、配置身份

很多新手直接克隆代码却报错，是因为还没告诉 Git '你是谁'。请在命令行依次输入以下两行（替换为你的真实信息）：

git config --global user.name "你的英文昵称"
git config --global user.email "你的邮箱@example.com"

配置完成，现在可以愉快地开始版本控制了。

配置速查清单

除了上述细节，以下 4 点最为关键，请务必确认：

1. 编辑器：别用 Vim，选 VS Code 或 Notepad。
2. 分支名：默认改为 main，与 GitHub 保持一致。
3. 环境变量：选第二个选项，确保 IDE 和 CMD 都能用 git。
4. HTTPS 后端：选 OpenSSL，比 Windows 原生通道更稳。

其余选项按推荐勾选，一路 Next 即可完成。