官网
安装

本教程以 Windows 64 位系统为例,可选择以下版本:
- Git for Windows x64 Setup(标准安装版)
- Git for Windows x64 Portable(便携版,无需安装)



注意:不要勾选 Only Show New Options,否则不会显示各种配置信息,包括安装路径。

选择组件
一般按照默认即可,点击 Next。

选择开始菜单文件夹
可以更改名称、不添加或者改到其他目录,一般保持默认;点击 Next 进入下一步。

设置默认文本编辑器
决定了使用 git commit 等命令时自动打开哪个编辑器来编写提交信息。
如何后续修改编辑器


设置默认初始分支名
决定了创建新 Git 仓库时,默认分支的名字。
Let Git decide 使用 Git 的默认分支名(目前是 master)。这是传统名称,但近年来很多团队和平台(如 GitHub)已改用 main。


设置 PATH 环境变量
- Use Git from Git Bash only
- 只在 Git Bash 中使用 Git 命令。
- PATH 不会修改,不会影响系统。
- 不能在 Windows 命令提示符(CMD)或 PowerShell 中直接使用 git 命令。
- 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)
- Checkout Windows-style, commit Unix-style line endings(推荐)
- 检出文件时:LF → CRLF(适合 Windows 编辑)
- 提交文件时:CRLF → LF(存储为 Unix 风格)
- 适合 Windows 用户参与跨平台项目(如与 Linux/macOS 开发者协作)。
- Checkout as-is, commit Unix-style line endings
- 检出时不转换,提交时 CRLF → LF
- 适合 Unix/macOS 用户或仅使用现代编辑器(如 VSCode)的 Windows 用户。

选择 Git Bash 的终端模拟器
- Use MinTTY (the default terminal of MSYS2)
- 推荐选择
- 功能更现代:支持窗口自由缩放、非矩形文本选择、更好的字体渲染、完整的滚动条等。
- 需要运行 Windows 控制台程序(如交互式 Python、Node.js)时,需在命令前加 winpty(例如:winpty python)。
- Use Windows' default console window
- 使用传统的 Windows 控制台(cmd.exe)。
- 优点:直接兼容所有 Windows 控制台程序,无需 winpty。
- 缺点:功能受限(滚动条有限、字体渲染可能有问题、窗口缩放不灵活)。
选择 git pull 的默认行为
决定了执行 git pull 时如何合并远程分支的更改到本地分支。
- Fast-forward or merge(推荐)
- 如果本地分支可以快进合并(即本地没有新提交),则直接移动指针。
- 如果不能快进(本地有提交),则创建合并提交(merge commit)。
- 适合大多数用户,保留完整历史。
- Rebase
- 将本地提交变基到远程分支之后(重写历史,使历史线更整洁)。
- 适合习惯保持线性历史的开发者,但需注意变基会改变提交哈希。
- Only ever fast-forward
- 只允许快进合并。
- 如果不能快进,则 git pull 会失败,需要手动处理。
- 适合严格保持线性历史的团队,但对新手不太友好。

选择凭证(登录信息)管理器
决定了 Git 如何保存你的账号密码或令牌(如访问 GitHub、GitLab 时的登录信息)
- Git Credential Manager(推荐)
- 自动保存你的 Git 远程仓库登录凭据(如 GitHub 用户名和密码/令牌)。
- 支持 Windows 凭据存储、macOS 钥匙串等。
- 方便安全,无需每次推送/拉取都输入密码。
- 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

输入命令,成功。



