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

• 解读：默认不勾选。一般很少专门双击图标打开，通常在项目文件夹右键打开或在编辑器里用。

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

把 Git 功能添加到鼠标右键菜单。

• Open Git Bash here (在这里打开 Git Bash)：必选！ 这是最高频的操作入口。没有它，每次都要手动输入 cd D:\我的项目\代码，非常痛苦。
• Open Git GUI here (在这里打开 Git GUI)：保留默认。图形界面看 Log 也挺直观。

Git LFS (Large File Support)

• 解读：必选。Git 原本存纯文本效率低，LFS 是专门帮 Git 高效管理大图片、视频、音频的扩展插件。

Associate .git configuration files with default text editor

• 解读：必选。让 .gitconfig 文件直接用编辑器打开，方便修改配置。

Associate .sh files to be run with Bash

• 解读：必选。关联 .sh 脚本文件，使其通过 Bash 运行，对跨平台自动化脚本很有用。

Check daily for Git for Windows update

• 解读：不要勾选。Git 很稳定，不需要天天更新检查，勾选了会弹窗骚扰。

Add a Git Bash Profile to Windows Terminal

• 解读：看个人喜好。如果用 Win11 或安装了 Windows Terminal，勾选后 Git Bash 会自动出现在下拉菜单里。

Scalar (Git add-on to manage large-scale repositories)

• 解读：保留默认。微软为管理巨型仓库开发的插件，个人项目用不上，但装了也不占资源。

3. 开始菜单文件夹

这一步很简单，直接点 "Next"。

• Select Start Menu Folder：选择开始菜单文件夹名。默认是 "Git"，千万别改。改成其他名字以后容易找不到。
• Don't create a Start Menu folder：不要勾选。留个入口总是好的。

4. 选编辑器

这一步是个'坑'，问的是 Git 需要写字（比如写提交备注）时自动打开哪个软件。

• 目前的默认选项 (Vim)：纯命令行古老编辑器，没鼠标操作，不能直接打字，保存退出难 (Esc + :wq)。如果保留这个，每次提交代码屏幕变黑，新手很容易卡死。
• 必须做的操作：千万不要直接点 Next！建议点击下拉菜单换掉 Vim！
  • 首选：Use Visual Studio Code as Git's default editor。如果装了 VS Code，选这个最舒服。
  • 保底：Use Notepad as Git's default editor。没装 VS Code就选记事本，虽简陋但不会卡住。

5. 分支命名

• Let Git decide (让 Git 决定)：使用默认名 master。这是老标准。
• Override the default branch name for new repositories (覆盖默认分支名)：🌟 推荐选择。改为 main。
• 为什么要改选第二个 (main)？
  1. 主流趋势：GitHub、GitLab 现在新建项目默认主分支都叫 main。
  2. 避免混乱：本地 master 远程 main，推送时会发现有两个主分支，管理麻烦。
  3. 统一标准：直接在安装时设为 main，本地和远程保持一致。

6. 配置路径 (PATH)

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

• ✅ 建议：保持默认 (选中间的)，直接点击「Next」即可。
• Use Git from Git Bash only：太不方便，只能在 Git Bash 里用，IDE 终端敲 git 会报错。
• Git from the command line and also from 3rd-party software：🌟 最佳选择。在任何地方（包括 PyCharm 终端）都能用 git 命令，且不干扰 Windows 系统命令。
• Use Git and optional Unix tools from the Command Prompt：千万别选。这会覆盖 Windows 自带的工具如 "find" 和 "sort"。

7. SSH 工具

• Use bundled OpenSSH：✅ 建议选这个。Git 自带经过测试的版本，开箱即用，不受环境变量影响，最稳定。
• Use external OpenSSH：给高级用户准备的。如果你已经手动配置了系统的 OpenSSH 并希望共用密钥才选这个。

8. 安全验证

• Use the OpenSSL library：🌟 推荐选择。Git 自带安全证书，独立于 Windows 系统设置，不管系统证书有没有问题，Git 都能稳定工作。个人开发者最稳妥。
• Use the native Windows Secure Channel library：用于大型公司环境，强制安装内部监控证书的情况。个人用户没必要。

9. 换行转换

设置换行符自动转换。Windows 和 Linux/macOS 对'换行'定义不同。

• Checkout Windows-style, commit Unix-style line endings：🌟 推荐选择。
  • 原理：下载代码时 (Checkout) 自动转成 Windows 格式 (CRLF)，上传代码时 (Commit) 自动变回标准格式 (LF)。
  • 解读：这是一个自动翻译机，防止因为用了 Windows 把团队代码格式搞乱。Windows 用户必选。
• Checkout as-is, commit Unix-style line endings：通常是 Unix/Linux 用户选的。Windows 用户选这个可能导致某些老软件打开文件显示成一行。
• Checkout as-is, commit as-is：完全不处理。容易造成跨平台协作灾难，别选。

10. 终端窗口

• Use MinTTY (the default terminal of MSYS2)：🌟 推荐选择。
  • 优点：类 Linux 风格，界面好看，支持自由缩放，支持像 Word 一样随意选择和复制文字。
• Use Windows' default console window：老式黑底白字 CMD 窗口。滚动受限，复制粘贴反人类，别选。

11. 拉取方式

设置 git pull 的默认行为。

• Fast-forward or merge (快进或合并)：🌟 推荐选择。
  • 快进：落后了补看几集，进度条直接走到最新。
  • 合并：两人同时写小说，把修改融合在一起。
  • 结论：自动处理这两种情况，最安全、符合直觉。
• Rebase (变基)：高级技巧，修改提交历史。新手容易把代码搞丢，慎用。
• Only ever fast-forward：只允许快进，有分叉就报错。人类用起来会很痛苦。

12. 记住密码

设置凭据管理器。

• Git Credential Manager：🌟 强烈推荐选择。
  • 作用：第一次连接 GitHub/GitLab 时弹出网页登录，加密保存在电脑里。以后推送代码时无感，不用每次都输密码。
• None (无)：后果是健忘症，每一次上传代码都弹窗问你是谁、密码多少，极其折磨人。

13. 配置性能

• Enable file system caching (启用文件系统缓存)：🌟 默认勾选 & 必须保留。
  • 原因：给 Git 加速。Windows 文件系统读取大量小文件慢，不勾选会导致 git status 卡顿。
• Enable symbolic links (启用符号链接)：⬜ 默认不勾 & 建议保持。
  • 坑点：开启比较麻烦，需要管理员权限，很多软件支持不完美。除非确定 Python 项目用到跨平台符号链接，否则别勾。

三、验证与初始化

除了上面几个关键节点外，其余页面一路点击 Next 即可。安装完成后，确认 Git 是否准备好。

1. 按下 Win + R，输入 cmd 并回车。
2. 输入以下命令并回车：

git --version

如果屏幕显示类似 git version 2.52.0.windows.1 的版本号，安装成功！

四、安装后的第一件事

很多新手安装完后直接克隆代码，结果报错。这是因为还没告诉 Git '你是谁'。请在命令行（CMD 或 PowerShell）中依次输入以下两行代码（把引号里的内容换成你的）：

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

配置完成！现在可以愉快地开始你的版本控制之旅了~