Git 完整安装与环境配置教程（Windows/macOS/Linux 通用）

[一、前言：Git 为何是开发者必备工具？](#一、前言：Git 为何是开发者必备工具？)

[二、Git 安装：多系统分步操作](#二、Git 安装：多系统分步操作)

[2.1 Windows 系统（Win10/Win11）](#2.1 Windows 系统（Win10/Win11）)

[步骤 1：下载安装包](#步骤 1：下载安装包)

[步骤 2：安装配置（关键步骤截图级说明）](#步骤 2：安装配置（关键步骤截图级说明）)

[步骤 3：验证安装](#步骤 3：验证安装)

[2.2 macOS 系统](#2.2 macOS 系统)

[方法 1：通过 Homebrew 安装（推荐，适合有 Homebrew 的用户）](#方法 1：通过 Homebrew 安装（推荐，适合有 Homebrew 的用户）)

[方法 2：官网直接安装](#方法 2：官网直接安装)

[2.3 Linux 系统（Ubuntu/Debian 系列）](#2.3 Linux 系统（Ubuntu/Debian 系列）)

[三、Git 核心环境配置（必做！）](#三、Git 核心环境配置（必做！）)

[3.1 配置用户信息（全局生效）](#3.1 配置用户信息（全局生效）)

[3.2 验证配置是否生效](#3.2 验证配置是否生效)

[3.3 可选优化配置（提升使用体验）](#3.3 可选优化配置（提升使用体验）)

[（1）配置默认文本编辑器（替换 Vim 为 VS Code）](#（1）配置默认文本编辑器（替换 Vim 为 VS Code）)

（2）配置代码换行符（避免跨系统协作冲突）

（3）配置颜色显示（命令输出更直观）

[四、Git 与远程仓库连接（以 GitHub 为例）](#四、Git 与远程仓库连接（以 GitHub 为例）)

[4.1 生成 SSH 密钥](#4.1 生成 SSH 密钥)

[4.2 复制 SSH 公钥（用于绑定远程仓库）](#4.2 复制 SSH 公钥（用于绑定远程仓库）)

[Windows 系统：](#Windows 系统：)

[macOS/Linux 系统：](#macOS/Linux 系统：)

[4.3 绑定 GitHub 仓库](#4.3 绑定 GitHub 仓库)

[4.4 验证 SSH 连接是否成功](#4.4 验证 SSH 连接是否成功)

[五、LLM 训练项目实战：Git 基础操作](#五、LLM 训练项目实战：Git 基础操作)

[5.1 本地创建项目仓库](#5.1 本地创建项目仓库)

[5.2 添加项目文件并提交](#5.2 添加项目文件并提交)

[5.3 关联远程仓库并推送](#5.3 关联远程仓库并推送)

[5.4 验证推送结果](#5.4 验证推送结果)

[六、常用 Git 命令速查（高频使用）](#六、常用 Git 命令速查（高频使用）)

七、常见问题与避坑指南

一、前言：Git 为何是开发者必备工具？

Git 是目前最流行的分布式版本控制系统，核心作用是 追踪代码变更、多人协作开发、回溯历史版本。在 LLM 模型训练、项目开发等场景中，Git 可帮助你：

管理训练代码、配置文件的版本迭代（避免误删 / 改乱无法恢复）
同步本地项目到 GitHub/Gitee 等远程仓库（配合 LLM 训练数据 / 模型备份）
与团队协作优化训练脚本、共享数据集处理方案

本文适用于 零基础开发者，全程附详细步骤 + 避坑指南，完成后可直接用于 LLM 训练项目的版本控制。

二、Git 安装：多系统分步操作

2.1 Windows 系统（Win10/Win11）

步骤 1：下载安装包

官网下载（推荐）：Git for Windows，自动匹配系统位数（32/64 位）
国内镜像（提速）：阿里云镜像，选择最新版本（如 Git-2.43.0-64-bit.exe）

步骤 2：安装配置（关键步骤截图级说明）

双击安装包，点击「Next」开始
选择安装路径（默认 C:\Program Files\Git，建议保持默认，避免中文路径）
组件选择（默认全选即可，重点勾选：Git Bash Here（右键菜单快捷打开）、Git GUI Here（图形化工具））
开始菜单文件夹：默认「Git」，直接下一步
选择默认编辑器：推荐「Visual Studio Code」（需提前安装），或保持默认「Vim」（后续可修改）
调整 PATH 环境变量：选择「Use Git from Git Bash only」（避免与系统其他工具冲突）
其余选项保持默认，一路「Next」，最后点击「Install」完成安装

步骤 3：验证安装

右键空白处，选择「Git Bash Here」，打开终端
输入命令：git --version，输出类似 git version 2.43.0.windows.1 即安装成功

2.2 macOS 系统

方法 1：通过 Homebrew 安装（推荐，适合有 Homebrew 的用户）

打开「终端」（Launchpad → 其他 → 终端）
输入安装命令：brew install git（等待自动完成，无需手动配置）
验证：git --version，输出版本号即成功

方法 2：官网直接安装

下载地址：Git for m acOS
双击 .dmg 安装包，拖拽 Git 到「应用程序」文件夹
终端输入 git --version 验证

2.3 Linux 系统（Ubuntu/Debian 系列）

打开终端，输入更新命令：sudo apt update
安装 Git：sudo apt install git -y（-y 表示自动确认）
验证：git --version，输出版本号即成功

三、Git 核心环境配置（必做！）

安装完成后，需配置 用户身份 （用于代码提交时标识作者）和 常用参数，所有配置通过 Git Bash / 终端执行。

3.1 配置用户信息（全局生效）

|-----------------------------------------------------------------------------------------------------------------------------------------------|
| # 配置用户名（建议与 GitHub/Gitee 用户名一致） git config --global user.name "你的用户名" # 配置邮箱（建议与 GitHub/Gitee 绑定邮箱一致） git config --global user.email "你的邮箱地址" |

3.2 验证配置是否生效

|----------------------------|
| git config --global --list |

输出类似以下内容即配置成功：

|----------------------------------------------|
| user.name=YourName user.email=your@email.com |

3.3 可选优化配置（提升使用体验）

（1）配置默认文本编辑器（替换 Vim 为 VS Code）

|--------------------------------------------------------------------------------------------------------------------------------------------------|
| # Windows 系统（需先安装 VS Code，并添加到环境变量） git config --global core.editor "code --wait" # macOS/Linux 系统 git config --global core.editor "code --wait" |

（2）配置代码换行符（避免跨系统协作冲突）

|-----------------------------------------------------------------------------------------------------------------------------------------------|
| # Windows 系统：提交时转换为 LF，拉取时保持 CRLF git config --global core.autocrlf true # macOS/Linux 系统：提交/拉取均保持 LF git config --global core.autocrlf input |

（3）配置颜色显示（命令输出更直观）

|-----------------------------------|
| git config --global color.ui true |

四、Git 与远程仓库连接（以 GitHub 为例）

LLM 训练项目需将代码 / 模型配置同步到远程仓库（如 GitHub/Gitee），推荐使用 SSH 密钥 连接（免密码登录，更安全）。

4.1 生成 SSH 密钥

打开 Git Bash / 终端，输入命令（邮箱替换为你的配置邮箱）：

|-------------------------------|
| ssh-keygen -t rsa -C "你的邮箱地址" |

连续按 3 次回车（默认保存路径 ~/.ssh/id_rsa，无需设置密码）
生成成功后，会在用户目录下创建 .ssh 文件夹（Windows：C:\Users\你的用户名\.ssh；macOS/Linux：~/.ssh）

4.2 复制 SSH 公钥（用于绑定远程仓库）

Windows 系统：

|-------------------------------------------------------|
| # 直接在 Git Bash 中复制公钥内容 cat ~/.ssh/id_rsa.pub | clip |

macOS/Linux 系统：

|----------------------------------------------|
| # 复制公钥内容（复制终端输出的全部内容） cat ~/.ssh/id_rsa.pub |

4.3 绑定 GitHub 仓库

登录 GitHub，点击右上角头像 →「Settings」→「SSH and GPG keys」→「New SSH key」
「Title」随便填（如「My Windows Git」），「Key」粘贴刚才复制的公钥内容
点击「Add SSH key」完成绑定

4.4 验证 SSH 连接是否成功

|-----------------------|
| ssh -T git@github.com |

首次连接会提示「Are you sure you want to continue connecting?」，输入 yes 回车，输出以下内容即成功：

|-------------------------------------------------------------------------------------------|
| Hi YourName! You've successfully authenticated, but GitHub does not provide shell access. |

五、LLM 训练项目实战：Git 基础操作

以 LLM 训练项目为例，演示「创建仓库→提交代码→推送到远程」的完整流程。

5.1 本地创建项目仓库

|------------------------------------------------------------------------------------------------------------------------------------------------|
| # 1. 创建项目文件夹（如 llm-training-project） mkdir llm-training-project # 2. 进入文件夹 cd llm-training-project # 3. 初始化 Git 仓库（让 Git 追踪该文件夹的文件变更） git init |

5.2 添加项目文件并提交

假设项目中已有 train.py（训练脚本）、data_process.py（数据处理脚本）、requirements.txt（依赖清单）：

|-----------------------------------------------------------------------------------------------------------------------------------------------------|
| # 1. 查看文件状态（红色表示未追踪） git status # 2. 添加所有文件到暂存区（追踪文件） git add . # "." 表示当前文件夹所有文件 # 3. 提交到本地仓库（备注提交内容，必填！） git commit -m "初始化LLM训练项目：添加训练脚本、数据处理脚本" |

5.3 关联远程仓库并推送

先在 GitHub 创建远程仓库（如 llm-training-project，无需勾选「Initialize this repository with a README」）
执行以下命令关联并推送：

|--------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| # 关联远程仓库（替换为你的 GitHub 仓库 SSH 地址） git remote add origin git@github.com:YourName/llm-training-project.git # 推送到远程仓库（首次推送需加 -u，后续直接 git push） git push -u origin main |

5.4 验证推送结果

打开 GitHub 远程仓库页面，即可看到本地提交的所有文件，完成代码同步！

六、常用 Git 命令速查（高频使用）

|-----------------|--------------------------------------|
| 命令用途 | 命令代码 |
| 查看仓库状态 | git status |
| 添加文件到暂存区 | git add 文件名 / git add .（全部添加） |
| 提交暂存区文件到本地仓库 | git commit -m "提交备注" |
| 拉取远程仓库最新代码 | git pull |
| 推送本地代码到远程仓库 | git push（首次 git push -u origin main） |
| 查看提交历史 | git log（退出按 q） |
| 撤销本地文件修改（未 add） | git checkout 文件名 |
| 撤销暂存区修改（已 add） | git reset HEAD 文件名 |

七、常见问题与避坑指南

安装后终端输入 git 提示「不是内部或外部命令」
- 原因：Git 未添加到系统环境变量
- 解决：重新运行安装包，在「调整 PATH 环境变量」步骤选择「Use Git from the command line and also from 3rd-party software」，或手动添加 Git 安装目录下的 bin 文件夹到系统环境变量。

SSH 连接 GitHub 提示「Permission denied」
- 原因：公钥未正确绑定 GitHub，或密钥文件权限错误
- 解决：重新生成 SSH 密钥并绑定；Windows 系统需确保 .ssh 文件夹权限为「只读」（右键文件夹→属性→安全→编辑，只保留当前用户的读取权限）。

推送代码提示「fatal: remote origin already exists」
- 原因：已关联过其他远程仓库
- 解决：先删除原有关联：git remote rm origin，再重新执行 git remote add origin ...。

LLM 训练数据 / 模型文件过大，推送失败
- 原因：Git 不适合追踪大文件（>100MB）
- 解决：使用 Git LFS（大文件存储）：git lfs install，然后追踪大文件：git lfs track "*.pth"（追踪所有 .pth 模型文件），再提交推送。