Windows Git 安装与配置详解 (2025 版)

附加图标 (Additional icons)

• On the Desktop：桌面快捷方式。不推荐勾选，项目文件夹右键菜单更方便。

Windows Explorer integration (资源管理器集成) ⭐ 核心

• Open Git Bash here：必选。在文件夹右键即可打开命令行并自动定位，省去输入长路径的麻烦。
• Open Git GUI here：保留默认。图形界面查看历史有时更直观。

Git LFS (Large File Support)

• 必选。用于高效管理大文件（图片、视频），防止仓库膨胀。

关联配置文件 (.gitconfig)

• 必选。双击 .gitconfig 文件时直接用编辑器打开，方便修改。

关联 .sh 文件

• 必选。允许在 Windows 上运行 Linux 脚本。

每日检查更新

• 不要勾选。Git 稳定，无需频繁弹窗检查。

Windows Terminal 配置

• 看个人喜好。若使用 Win11 自带终端或安装了 Windows Terminal，可勾选以便调用。

Scalar

• 保留默认。微软开发的超大型仓库管理插件，普通项目无感占用，留着备用即可。

4. 开始菜单文件夹

直接点击 Next，保持默认的 "Git" 文件夹名，便于日后查找。

5. 默认编辑器 ⚠️ 避坑重点

这一步决定了提交代码时用什么软件写备注。

• 默认 Vim：纯命令行古老编辑器，无鼠标操作，保存退出复杂 (:wq)。新手极易卡死。
• 推荐 Visual Studio Code：如果已安装，首选它，界面熟悉。
• 保底 Notepad：没装 VS Code 就选记事本，简单可靠。

操作：务必下拉菜单切换，不要直接点 Next！

6. 分支命名

• Let Git decide：默认 master，旧标准。
• Override...：推荐选择，填入 main。

为什么改？ GitHub、GitLab 等主流平台现在默认主分支都是 main。本地设为 main 能避免推送时出现分支混乱。

7. 环境变量 PATH

决定在哪里能输入 git 命令。

• Use Git from Git Bash only：太局限，IDE 终端无法用。
• Git from command line and also from 3rd-party software：推荐。CMD、PowerShell、PyCharm 都能用，且不干扰系统命令。
• Use Git and optional Unix tools...：警告会覆盖 Windows 自带工具，别选。

8. SSH 工具

• Use bundled OpenSSH：推荐。Git 自带，开箱即用，最稳定。
• Use external OpenSSH：高级用户专用，需自行配置系统 SSH。

9. 安全验证

• Use OpenSSL library：推荐。独立证书库，不受 Windows 系统设置影响，个人开发者最稳。
• Use native Windows Secure Channel：适用于公司内网强制证书环境。

10. 换行转换

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

• Checkout Windows-style, commit Unix-style：推荐。下载时转成 Windows 格式防乱码，上传时转回 Unix 格式保统一。跨平台协作必备。

11. 终端窗口

• Use MinTTY：推荐。类 Linux 风格，支持缩放、复制粘贴友好，界面现代。
• Use Windows' default console：老式 CMD 黑框，操作反人类，除非特殊需求别选。

12. 拉取方式

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

13. 记住密码

• Git Credential Manager：强烈推荐。首次登录网页授权后，后续 push/pull 自动认证，无需重复输密码。
• None：每次都要输密码，极度折磨。

14. 性能配置

• Enable file system caching：必须勾选。提升 Git 在 Windows 上的读取速度，否则大项目操作会卡顿。
• Enable symbolic links：默认不勾。涉及符号链接权限问题，普通项目不需要。

关键节点速查

除了上述细节，以下 4 处最容易踩坑，请重点确认：

1. 编辑器：避开 Vim，改用 VS Code 或 Notepad。
2. 分支名：改为 main 以匹配主流平台。
3. PATH：选第二个选项，确保 IDE 终端可用。
4. HTTPS 后端：选 OpenSSL 库，稳定性更好。

其余步骤一路 Next 即可。

验证与初始化

安装完成后，打开 CMD 输入：

git --version

显示版本号即表示成功。

配置身份

Git 需要知道'你是谁'才能记录提交信息。依次执行：

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

配置完毕，即可开始版本控制之旅。