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

3. 开始菜单文件夹

保持默认的 "Git" 文件夹名称。改名可能导致日后难以定位工具入口。

4. 默认编辑器（重要）

这一步常被忽略，却是新手最容易卡壳的地方。Git 需要输入提交信息时会唤起编辑器。

• 默认选项 Vim：命令行古老编辑器，无鼠标支持，退出需输入 :wq。新手极易因操作不当导致无法保存，甚至强制关闭窗口。
• 推荐修改：在下拉菜单中选择 Visual Studio Code（已安装）或 Notepad（记事本）。

选择 VS Code 或记事本后，会弹出熟悉的文本窗口，支持鼠标粘贴和正常保存，体验流畅得多。

5. 分支命名

• Let Git decide：默认主分支名为 master。这是旧标准。
• Override the default branch name：推荐选择。将新仓库默认分支设为 main。

理由：GitHub、GitLab 等平台现已普遍采用 main 作为默认主分支。本地统一为 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、PyCharm 等第三方软件中通用，且不干扰系统命令。
• Use Git and optional Unix tools from the Command Prompt：别选。这会覆盖 Windows 自带的 find、sort 等命令，引发系统级冲突。

7. SSH 工具

• Use bundled OpenSSH：推荐。使用 Git 包内自带的 SSH 版本，开箱即用，稳定性高。
• Use external OpenSSH：仅适合高级用户，需手动配置系统级 SSH 环境。

8. HTTPS 传输后端

• Use OpenSSL library：推荐。Git 自带证书库，独立于 Windows 系统，不受公司策略或系统更新影响，连接更稳定。
• Use native Windows Secure Channel library：依赖系统证书存储，多用于企业内网环境。

9. 换行符转换

• Checkout Windows-style, commit Unix-style：推荐。检出时自动转为 Windows 格式（防乱码），提交时转回 Unix 格式（LF，保持仓库整洁）。跨平台协作必备。
• Checkout as-is, commit as-is：完全不处理，易导致跨平台代码格式混乱。

10. 终端模拟器

• Use MinTTY：推荐。类 Linux 风格终端，支持自由缩放、文字复制，配色现代。
• Use Windows' default console window：老式 CMD 窗口，复制粘贴体验较差。

11. 拉取行为

• Fast-forward or merge：推荐。Git 经典模式，自动处理快进或合并提交，最安全。
• Rebase：高级用法，会重写提交历史，新手慎用。

12. 凭据管理器

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

13. 性能优化

• Enable file system caching：必须勾选。显著提升 Git 在 Windows NTFS 文件系统上的读取速度，避免大项目操作卡顿。
• Enable symbolic links：默认不勾。符号链接在 Windows 上权限复杂，普通开发无需开启。

验证与初始化

安装完成后，打开 CMD 或 PowerShell 输入以下命令确认版本：

git --version

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

后续配置

安装完 Git 后，第一件事是告诉它'你是谁'。在命令行依次执行：

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

完成上述配置，你的 Git 环境即可投入生产使用。