Windows 下 Git 安装配置与 Gitee 远程仓库连接指南

如何后续修改编辑器

设置默认初始分支名

决定了创建新 Git 仓库时，默认分支的名字。

Let Git decide 使用 Git 的默认分支名（目前是 master）。这是传统名称，但近年来很多团队和平台（如 GitHub）已改用 main。

设置 PATH 环境变量

1. Use Git from Git Bash only
   • 只在 Git Bash 中使用 Git 命令。
   • PATH 不会修改，不会影响系统。
   • 不能在 Windows 命令提示符（CMD）或 PowerShell 中直接使用 git 命令。
2. Git from the command line and also from 3rd-party software（推荐）
   • 将 Git 的核心命令添加到系统 PATH 中。
   • 你可以在 Git Bash、CMD、PowerShell、第三方软件中直接使用 git 命令。
   • 推荐选择此项，方便日常使用。

选择 SSH 可执行程序

决定了 Git 使用哪个 SSH 客户端来连接远程仓库（如 GitHub、GitLab）。

• Use bundled OpenSSH（推荐） 使用 Git 自带的 OpenSSH 客户端（ssh.exe）。 优点：独立、稳定，不与系统已有 SSH 冲突，适合大多数用户。
• Use external OpenSSH 使用系统中已有的 OpenSSH（比如 Windows 10/11 自带的 OpenSSH 客户端）。 注意：如果你不确定自己是否有或需要外部 SSH，建议不要选此项。

选择 HTTPS 传输后端

决定了 Git 使用哪个 SSL/TLS 库来验证 HTTPS 连接的服务器证书（比如访问 GitHub、GitLab 等）。

• Use the OpenSSL library 使用 Git 自带的 OpenSSL 库进行证书验证。 特点：使用 Git 自带的 ca-bundle.crt 证书文件，独立于 Windows 系统证书。
• Use the native Windows Secure Channel library 使用 Windows 自带的 Secure Channel（Schannel）库进行证书验证。 特点：使用 Windows 系统证书存储，方便企业用户使用内部 CA 证书（如公司内网代理、自签名证书等）。

如果你是普通个人用户，建议选择第一个选项（OpenSSL），然后点击 Next。

如果你在公司或学校内网环境下，可能需要使用公司内部的证书，可以选择第二个选项（Windows Secure Channel）。

后续修改

配置换行符转换

决定了 Git 如何处理文本文件中的换行符（Windows 用 CRLF，Unix/Linux/macOS 用 LF）

1. Checkout Windows-style, commit Unix-style line endings（推荐）
   • 检出文件时：LF → CRLF（适合 Windows 编辑）
   • 提交文件时：CRLF → LF（存储为 Unix 风格）
   • 适合 Windows 用户参与跨平台项目（如与 Linux/macOS 开发者协作）。
2. Checkout as-is, commit Unix-style line endings
   • 检出时不转换，提交时 CRLF → LF
   • 适合 Unix/macOS 用户或仅使用现代编辑器（如 VSCode）的 Windows 用户。

选择 Git Bash 的终端模拟器

1. Use MinTTY (the default terminal of MSYS2)
   • 推荐选择
   • 功能更现代：支持窗口自由缩放、非矩形文本选择、更好的字体渲染、完整的滚动条等。
   • 需要运行 Windows 控制台程序（如交互式 Python、Node.js）时，需在命令前加 winpty（例如：winpty python）。
2. Use Windows' default console window
   • 使用传统的 Windows 控制台（cmd.exe）。
   • 优点：直接兼容所有 Windows 控制台程序，无需 winpty。
   • 缺点：功能受限（滚动条有限、字体渲染可能有问题、窗口缩放不灵活）。

选择 git pull 的默认行为

决定了执行 git pull 时如何合并远程分支的更改到本地分支。

1. Fast-forward or merge（推荐）
   • 如果本地分支可以快进合并（即本地没有新提交），则直接移动指针。
   • 如果不能快进（本地有提交），则创建合并提交（merge commit）。
   • 适合大多数用户，保留完整历史。
2. Rebase
   • 将本地提交变基到远程分支之后（重写历史，使历史线更整洁）。
   • 适合习惯保持线性历史的开发者，但需注意变基会改变提交哈希。
3. Only ever fast-forward
   • 只允许快进合并。
   • 如果不能快进，则 git pull 会失败，需要手动处理。
   • 适合严格保持线性历史的团队，但对新手不太友好。

选择凭证（登录信息）管理器

决定了 Git 如何保存你的账号密码或令牌（如访问 GitHub、GitLab 时的登录信息）

1. Git Credential Manager（推荐）
   • 自动保存你的 Git 远程仓库登录凭据（如 GitHub 用户名和密码/令牌）。
   • 支持 Windows 凭据存储、macOS 钥匙串等。
   • 方便安全，无需每次推送/拉取都输入密码。
2. None
   • 不使用任何凭证助手。
   • 每次操作远程仓库都需要手动输入用户名和密码（或令牌）。
   • 不推荐，除非你有特殊的安全策略。

配置额外选项

• ✅ Enable file system caching（推荐勾选） 启用文件系统缓存，Git 会批量读取文件系统数据并缓存到内存中，能显著提升操作速度（如状态检查、提交等）。 建议保持勾选，除非你的内存非常紧张。
• 🔗 Enable symbolic links（可选） 启用符号链接（软链接）支持。 注意：需要系统权限（SeCreateSymbolicLink），且不影响已有仓库。 如果你不创建或不需要使用符号链接，可以不勾选。

• Launch Git Bash：如果勾选，安装完成后会自动打开 Git Bash（一个命令行工具，用于运行 Git 命令）。
• View Release Notes：如果勾选，会打开浏览器查看 Git 的版本更新说明。

配置

检查安装成功

选择一个盘符，创建一个新的文件夹，右键。

输入 git，如下图所示则安装成功，或者输入 git --version 查看。

git config --global --list 是一个 Git 命令，用于列出当前用户的所有全局 Git 配置项。

这个错误表示你的全局 Git 配置文件（.gitconfig）不存在，因为你还没设置过任何全局配置。

配置用户名和邮箱

检查配置是否成功。

修改配置文件

也可以通过记事本打开 .gitconfig 文件进行配置。

• git status 用于查看当前仓库的状态（如哪些文件已修改、已暂存等）。
• 但该命令必须在 Git 仓库目录中执行（即该目录或上级目录包含 .git 文件夹）。

初始化仓库

创建 Git 本地仓库，先初始化仓库。

查看仓库文件夹发现多了一个 .git 文件。

同时，在命令行最后多了一个 'main'（因为我们在安装的时候选择的是使用 main 作为新仓库的分支名称的），这代表目前处于仓库的 main 分支。

在本地仓库新建一个文本文档，查看仓库状态（git status）。

• On branch main：当前在 main 分支。
• No commits yet：仓库还没有任何提交（第一次初始化）。
• Untracked files：有一个未被跟踪的文件 test01.txt（Git 尚未开始管理它）。

• Changes to be committed：test01.txt 已暂存，等待提交。
• 提示你可以用 git rm --cached 将文件从暂存区移除（如果不想提交它）。

记得要输入 git commit -m "提交信息"（提交信息自定义，其实就是备注信息）。

Git 的提交信息编辑界面。这是因为执行 git commit 时没有使用 -m 参数指定提交信息，所以 Git 打开了默认编辑器手动输入。

如果输入的是 git commit 就会进入到 git 的提交信息编辑界面。

解决方法：

输入 git log 就可以查看到提交的作者、时间、提交信息。

git branch

• 查看当前仓库有哪些分支。
• 当前所在分支前面会有一个 * 号标记。

为常用命令配置别名

打开用户目录，创建 .bashrc 文件，找不到文件就输入

ls -la ~/.bashrc

用记事本打开 .bashrc，输入如下：

输入 git-log 如果没有正确显示日志，可以先查看

cat ~/.bashrc

确认别名成功配置，查看输出中是否有 alias git-log=... 这一行。

如果有但是命令执行失败可能没有被 Git Bash 加载，输入：

source ~/.bashrc

手动重新加载，但是注意可能存在文字乱码问题。

配置 .bashrc 文件解决编码问题：

应用后保存即可。

Gitee 码云远程仓库连接

初始化本地仓库后设置提交忽略文件

touch .gitignore

常用 .gitignore 配置示例：

# 编译产物 target/ classes/ *.class 
# 依赖管理 *.jar *.war *.ear .m2/ 
# Maven 本地仓库（通常不提交） 
# IntelliJ IDEA Files .idea/ *.iml *.ipr *.iws *.idea .classpath .project

输入命令，成功。