Windows Git 安装配置指南：避坑与最佳实践 (2025 版)

3. 开始菜单文件夹

保持默认的 "Git" 文件夹名称即可。改名容易导致记忆混乱，增加查找成本。

4. 默认编辑器（关键！）

这一步决定 Git 需要输入提交信息时调用的软件。默认选项通常是 Vim，这是一个纯命令行古老编辑器，操作反人类（需按 i 进入编辑，:wq 退出），新手极易卡死。

强烈建议修改为：

• 首选：Use Visual Studio Code as Git's default editor（如果已安装 VS Code）。
• 保底：Use Notepad as Git's default editor（记事本）。

这样提交代码时会弹出熟悉的窗口，打字保存即可，体验流畅。

5. 分支命名

GitHub 和 GitLab 等主流平台现在默认主分支名为 main，而非传统的 master。为了保持本地与远程一致，避免推送时的混乱，建议选择覆盖默认分支名并填入 main。

6. 环境变量 PATH

这决定了你在哪些地方能直接使用 git 命令。

• Use Git from Git Bash only：太保守，只能在 Git Bash 里用，IDE 终端无法调用。
• Git from the command line and also from 3rd-party software：推荐选中。可在 CMD、PowerShell 及 IDE 终端中使用，且不干扰系统命令。
• Use Git and optional Unix tools from the Command Prompt：千万别选。这会覆盖 Windows 自带工具如 find 和 sort，容易引发系统级冲突。

7. SSH 工具与 HTTPS 后端

• SSH Executable：选 Use bundled OpenSSH。Git 自带的版本经过测试，开箱即用，最稳定。
• HTTPS transport backend：选 Use OpenSSL library。Git 自带证书验证，独立于 Windows 系统，不受公司内网策略影响，对个人开发者更稳妥。

8. 换行符转换

Windows 和 Linux/macOS 的换行符定义不同（CRLF vs LF）。

• Checkout Windows-style, commit Unix-style：推荐选择。检出时自动转为 Windows 格式（记事本不乱码），提交时自动转回 Unix 格式（仓库统一）。这是防止跨平台协作灾难的'翻译机'。

9. 终端模拟器

• Use MinTTY：推荐选择。类 Linux 风格，界面美观，支持自由缩放和文本复制，字体配色更现代。
• Use Windows' default console window：老式黑底白字窗口，滚动和复制体验较差，除非有特殊怀旧需求，否则不建议。

10. 拉取行为与凭据管理

• git pull behavior：选 Fast-forward or merge。这是经典标准模式，能自动处理快进或合并提交，最安全。
• Credential Helper：选 Git Credential Manager。它会加密保存通行证，以后推送代码时无需反复输入账号密码，极大提升效率。

11. 性能优化

• Enable file system caching：务必勾选。Git 在 Windows NTFS 文件系统上读取大量小文件较慢，开启缓存可显著提升 git status 等操作的响应速度。
• Enable symbolic links：默认不勾。除非明确知道项目需要跨平台符号链接，否则保持默认以避免权限报错。

三、验证与初始化

安装完成后，按下 Win + R，输入 cmd 并回车，输入以下命令确认版本：

git --version

若显示版本号（如 git version 2.x.x.windows.1），说明安装成功。

最后一步，告诉 Git 你是谁。在命令行依次输入（替换为你的真实信息）：

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

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