Windows 系统 Git 安装与配置指南

设置 Git 需要输入文字（如提交说明）时自动打开的软件。推荐选择 VS Code。

调整新代码仓库中初始分支的名称（Adjusting the name of the initial branch in new repositories）

过去 Git 默认主分支名为 master。约从 2020 年开始，为避免主从隐喻及更中性表述，GitHub 等平台已将默认分支名改为 main。

Let Git decide (让 Git 决定)

沿用 Git 软件内部默认的旧名字 —— master。

Override the default branch name（覆盖默认分支名）

手动指定新名字，通常填入 main。

选择第二个

调整你的 PATH 环境变量（Adjusting your PATH environment）

决定在哪些地方能够使用 Git 命令。

选项 1：Use Git from Git Bash only (仅在 Git Bash 中使用 Git)

最保守选项。Git 命令仅能在专门打开'Git Bash'时使用。CMD、PowerShell 或 VS Code 终端中输入 git 无法识别。

选项 2：Git from the command line and also from 3rd-party software (在命令行和第三方软件中使用 Git)

标准且推荐的选择。将 Git 核心命令放入系统 PATH 环境变量，可在 CMD、PowerShell、Windows Terminal 中直接使用。

选项 3：Use Git and optional Unix tools from the Command Prompt (在命令提示符中使用 Git 和可选的 Unix 工具)

激进选项。除 Git 外还将 Linux/Unix 工具（如 ls, find, sort 等）加入系统路径。可能覆盖 Windows 自带同名命令。

保持默认选择第二个

选择 SSH 可执行文件（Choosing the SSH executable）

选项 1：Use bundled OpenSSH (使用内置的 OpenSSH)

Git 安装包自带完整标准的 OpenSSH 工具。官方测试版本，与 Git 配合完美。

选项 2：Use external OpenSSH (使用外部的 OpenSSH)

使用 Windows 系统已安装的 SSH 工具。

保持默认选择

选择 HTTPS 传输后端（Choosing HTTPS transport backend）

决定 Git 进行 HTTPS 连接时的安全检查负责方。

选项 1：Use the OpenSSL library (使用 OpenSSL 库)

Git 官方默认标准。使用自带的证书文件验证服务器安全性。

选项 2：Use the native Windows Secure Channel library (使用 Windows 原生安全通道库)

使用 Windows 系统的证书列表。

推荐选第一个

配置行尾转换格式（Configuring the line ending conversions）

解决 Windows 与 Linux/Mac 系统间换行符差异问题。

• Windows 系统：使用 \r\n (CRLF)
• Linux / Mac / Unix 系统：使用 \n (LF)

选项 1：Checkout Windows-style, commit Unix-style line endings

检出时转成 Windows 风格，提交时转成 Unix 风格。

• Checkout (拉取代码时)： Git 发现仓库里是 LF，下载时自动转换成 CRLF。
• Commit (提交代码时)： Git 把文件里的 CRLF 自动转换回 LF，再存入仓库。

选项 2：Checkout as-is, commit Unix-style line endings

检出时不转换，提交时转成 Unix 风格。通常给 Mac 或 Linux 用户用。

选项 3：Checkout as-is, commit as-is

原样进出，仓库中会混杂 LF 和 CRLF。

选择第一个

配置 Git Bash 使用的终端模拟器（Configuring the terminal emulator to use with Git Bash）

决定直接打开 Git Bash 时使用的窗口程序。

选项 1：Use MinTTY (the default terminal of MSYS2)

使用 MinTTY 作为终端模拟器。Git for Windows 基于 MSYS2 构建，MinTTY 是其原生窗口。

选项 2：Use Windows' default console window

使用 Windows 传统的'命令提示符'窗口。

选择第一个

选择 git pull 的默认行为

Choose the default behavior of git pull

决定本地有修改且服务器有新代码时，git pull 如何合并。

选项 1：Fast-forward or merge (快进或合并)

标准做法。

• 情况 A（理想情况）： 无本地修改，直接更新进度条（Fast-forward）。
• 情况 B（分叉情况）： 双方都有修改，自动生成'合并提交'，历史树状图会有分叉汇合。

选项 2：Rebase (变基)

将本地修改先拿下来，插入服务器更新之后，再贴在最上面。历史图是一条直线，无分叉。

选项 3：Only ever fast-forward (仅允许快进)

绝不自动合并。若有分叉则报错退出，需手动处理。

选择第一个

选择凭据助手

Choose a credential helper

决定 Git 如何保存远程仓库登录信息。

选项 1：Git Credential Manager

安全的凭证助手，帮助安全存储和管理 GitHub 等远程仓库的登录信息。

选项 2：None

每次操作需手动输入密码。

选择第一个

配置额外选项

选项 1：Enable file system caching (启用文件系统缓存)

将文件信息（如修改时间、大小）临时存在内存中。Windows NTFS 处理海量小文件较慢，开启缓存可提升大项目操作速度。

选项 2：Enable symbolic links (启用符号链接)

Linux/Mac 常用，Windows 支持不完善。普通开发通常不需要。

选择第一个

验证

打开 cmd，输入以下命令：

git --version