🔥 前言

在现代软件开发中，Git 已经成为了代码版本管理的事实标准。无论是个人开发还是团队协作，掌握 Git 不仅能让你避免 “删库跑路” 的尴尬，还能极大地提升团队的开发效率。

本文将从最基础的安装配置，到核心的分支管理策略（Git Flow），再到结合 GitHub/Gitee 进行团队协作与 Issue 问题追踪，为您带来一站式的 Git 实战教程。

---

<a id="1">一、 Git 环境搭建与基础配置</a>

1. 安装 Git

• Windows: 下载 Git for Windows，安装时建议使用默认选项，勾选 “Git Bash Here”。
• Mac: 使用 Homebrew 安装 brew install git，或从官网下载。
• Linux: sudo apt-get install git (Debian/Ubuntu) 或 sudo yum install git (CentOS)。

2. 基础配置 (Identity)

安装完成后，第一件事是告诉 Git 你是谁。打开终端（Terminal）或 Git Bash，输入以下命令：

bash

运行

# 配置用户名（建议与GitHub/Gitee一致）
git config --global user.name "Your Name"

# 配置邮箱（用于接收通知）
git config --global user.email "youremail@example.com"

# 查看配置信息
git config --list

💡 小贴士：--global 参数表示全局配置，所有项目都会生效。如果某个项目需要单独配置，可以不加此参数，进入项目目录后再配置。

---

<a id="2">二、 Git 核心工作流与基础命令</a>

Git 的核心在于工作区 (Workspace)、暂存区 (Index/Staging Area) 和 版本库 (Repository) 之间的流转。

1. 初始化仓库

bash

运行

# 创建一个新文件夹并进入
mkdir my-project && cd my-project

# 初始化Git仓库
git init

2. 文件的生命周期操作

bash

运行

# 1. 查看文件状态 (最常用命令)
git status

# 2. 将文件从【工作区】添加到【暂存区】
git add filename.txt       # 添加指定文件
git add .                  # 添加当前目录所有改动文件

# 3. 将文件从【暂存区】提交到【版本库】
# -m 后面跟的是提交信息（必须有意义）
git commit -m "feat: 初始化项目结构，添加README"

# 4. 查看提交历史
git log                    # 详细日志
git log --oneline          # 简洁日志 (推荐)
git log --graph            # 图形化查看分支历史

---

<a id="3">三、 分支管理与协作策略 (Git Flow)</a>

分支是 Git 最强大的功能。良好的分支策略是团队协作的基石。

1. 常见分支介绍

• master / main: 主分支，存放生产环境代码，随时可部署。
• develop: 开发分支，团队日常开发的集成分支。
• feature/*: 功能分支，用于开发新需求（如 feature/login-page）。
• bugfix/*: 修补分支，用于修复开发环境的 Bug。
• hotfix/*: 紧急修复分支，用于修复生产环境的线上 Bug。

2. 常用分支命令

bash

运行

# 查看本地分支
git branch

# 查看所有分支 (含远程)
git branch -a

# 创建并切换到新分支
git checkout -b feature/user-auth

# 或者使用新版命令
git switch -c feature/user-auth

# 切换回develop分支
git checkout develop

# 合并分支 (例如：将feature合并到develop)
git merge feature/user-auth

# 删除分支 (合并完成后)
git branch -d feature/user-auth

⚠️ 注意： 合并时如果发生冲突（Conflict），需要手动编辑冲突文件，解决后重新 add 和 commit。

---

<a id="4">四、 远程仓库操作 (Push/Pull/Fetch)</a>

本地写好代码后，需要同步到远程仓库（如 GitHub、Gitee、GitLab）。

1. 关联远程仓库

bash

运行

# 方式一：先克隆远程仓库 (适合新项目)
git clone https://github.com/yourname/your-repo.git

# 方式二：本地已有项目，关联远程
git remote add origin https://github.com/yourname/your-repo.git

2. 推送代码 (Push)

bash

运行

# 将本地develop分支推送到远程origin的develop分支
git push -u origin develop
# -u 表示建立上游关联，下次直接 git push 即可

3. 拉取代码 (Pull/Fetch)

bash

运行

# 拉取远程代码并自动合并 (相当于 git fetch + git merge)
git pull origin develop

# 仅拉取远程信息，不合并 (更安全)
git fetch origin
git merge origin/develop

---

<a id="5">五、 团队协作与 Code Review</a>

在团队中，直接向 master 或 develop 推送代码通常是被禁止的。标准流程是使用 Pull Request (PR) 或 Merge Request (MR)。

流程演示：

1. Fork (如果是开源项目) 或 Clone 项目。
2. 创建 Feature Branch 进行开发。
3. 开发完成后，Push 分支到远程。
4. 在 GitHub/Gitee 网页上点击 "New Pull Request"。
5. 指定源分支（你的 feature 分支）和目标分支（团队的 develop）。
6. 填写 PR 描述，@相关同事进行 Code Review (代码审查)。
7. 审查通过后，由管理员点击 "Merge" 合并代码。

---

<a id="6">六、 Issue 问题追踪与提交规范</a>

Git 不仅管理代码，还能通过 Issue 管理任务和 Bug。

1. 使用 Issue

• 在 GitHub/Gitee 仓库页面点击 "Issues" -> "New issue"。
• 填写标题（如：【Bug】登录按钮点击无反应）和描述。
• 分配给具体的开发人员。

2. 提交信息规范 (Commit Message)

为了让历史记录清晰，并能自动关联 Issue，建议遵循 Conventional Commits 规范。

格式：

text

<type>(<scope>): <subject>

[optional body]

[optional footer]

示例：

bash

运行

# 修复了Issue #123 的Bug
git commit -m "fix(login): 修复验证码过期导致的登录失败 #123"

# 新增功能
git commit -m "feat(dashboard): 添加用户数据统计图表"

# 文档更新
git commit -m "docs: 更新API文档说明"

✨ 魔法： 如果提交信息中包含 fixes #123 或 closes #123，当 PR 被合并时，GitHub 会自动关闭编号为 123 的 Issue。

---

<a id="7">七、 常见问题与避坑指南</a>

1. Q: 不小心 git add 了不想提交的文件怎么办？

   • A: git reset HEAD filename (取消暂存)。

2. Q: 代码改错了，想回退到上一个版本怎么办？

   • A: git reset --hard HEAD^ (回退到上一版本，慎用，会丢弃当前修改)。

3. Q: 忘记密码或 token 失效怎么办？

   • A: Windows 可以在 “控制面板”->“凭据管理器” 中删除旧的 Git 凭据，下次拉取时会重新提示输入。

4. Q: 如何忽略某些文件不上传？

   • A: 在项目根目录创建 .gitignore 文件，写入不需要上传的文件 / 目录（如 node_modules/, *.log）。

---

📝 总结

Git 是程序员的必备技能。本文涵盖了从 单人版本控制 到 多人协作开发 的完整链路。

• 核心口诀： add 加文件，commit 做快照，branch 分岔路，merge 合代码，push 上云端。