Git使用手册：从基础到进阶的完整指南

一、Git基础概念与安装配置

1.1 Git的核心优势

Git作为分布式版本控制系统，其核心价值体现在三个层面：历史追溯（完整记录每次修改的作者、时间、内容）、分支管理（支持并行开发且无需依赖中央服务器）、协作效率（通过Pull Request或Merge Request实现代码审查与安全合并）。相较于SVN等集中式工具，Git的离线操作能力和轻量级分支模型显著提升了开发效率。

1.2 安装与环境配置

• Windows用户：推荐通过Git for Windows安装，勾选”Git Bash Here”选项以启用类Linux终端环境。
• Mac/Linux用户：使用包管理器安装（如brew install git或sudo apt-get install git）。
• 全局配置：

  git config --global user.name "Your Name"
  git config --global user.email "your.email@example.com"
  git config --global core.editor "code --wait"  # 配置VS Code为默认编辑器

  通过git config --list可验证配置是否生效。

二、基础操作与工作流

2.1 初始化与状态管理

• 创建仓库：

  mkdir my-project && cd my-project
  git init  # 初始化.git目录

• 状态检查：

  git status  # 显示未跟踪文件、暂存区变更及分支信息

  关键提示：git status -s可输出简洁格式（如?? file.txt表示未跟踪文件）。

2.2 版本提交流程

1. 添加文件到暂存区：

   git add file.txt          # 添加单个文件
   git add .                 # 添加所有修改（不含未跟踪文件）
   git add -u                # 添加所有已跟踪文件的修改

2. 提交版本：

   git commit -m "feat: add user authentication"  # 遵循Conventional Commits规范

   最佳实践：提交信息应包含类型（feat/fix/docs等）、范围及简明描述。

3. 查看历史：

   git log --oneline --graph  # 紧凑显示提交树
   git show HEAD~2            # 查看倒数第二次提交的详细变更

三、分支管理与策略

3.1 分支操作全解

• 创建与切换：

  git branch feature/login   # 创建分支
  git checkout feature/login # 切换分支（Git 2.23+推荐使用`git switch`）
  git switch -c hotfix/123   # 创建并切换到新分支

• 合并与变基：

  git merge main             # 将main分支合并到当前分支
  git rebase main            # 将当前分支变基到main（保持线性历史）

  冲突解决：合并冲突时，Git会在文件中标记<<<<<<<、=======、>>>>>>>，需手动编辑后执行git add和git commit。

3.2 团队协作策略

• Git Flow模型：
  • main分支：仅包含稳定版本
  • develop分支：集成开发功能
  • feature/*分支：开发新功能
  • release/*分支：预发布测试
  • hotfix/*分支：紧急修复
• GitHub Flow简化方案：
  1. 从main创建分支
  2. 提交代码并推送
  3. 发起Pull Request
  4. 代码审查后合并到main

四、远程仓库与协作

4.1 关联远程仓库

git remote add origin https://github.com/user/repo.git
git push -u origin main     # 首次推送需指定分支

4.2 同步远程变更

git fetch origin            # 获取远程更新但不合并
git pull origin main        # 等同于`git fetch` + `git merge`
git push origin feature/login  # 推送本地分支到远程

4.3 协作冲突处理

• 场景：多人修改同一文件导致git push被拒绝。
• 解决方案：

  git pull --rebase origin main  # 变基式拉取
  # 手动解决冲突后执行
  git rebase --continue
  git push origin feature/login

五、高级技巧与工具链

5.1 .gitignore文件配置

# 忽略所有.log文件
*.log
# 排除特定文件
!important.log
# 忽略node_modules目录
node_modules/

5.2 标签与发布管理

git tag v1.0.0              # 创建轻量级标签
git tag -a v1.0.1 -m "Release notes"  # 创建附注标签
git push origin v1.0.0      # 推送标签到远程

5.3 子模块集成

git submodule add https://github.com/user/lib.git libs/mylib
git submodule update --init  # 初始化子模块

六、常见问题解决方案

6.1 回滚操作

• 撤销未提交修改：

  git checkout -- file.txt  # 丢弃工作区修改

• 撤销已提交内容：

  git reset HEAD~1          # 软回滚（保留修改）
  git reset --hard HEAD~1   # 硬回滚（彻底丢弃）
  git revert HEAD           # 创建反向提交（安全用于公共分支）

  6.2 存储临时修改

  git stash                  # 暂存当前修改
  git stash pop              # 恢复并删除暂存
  git stash list             # 查看暂存列表

七、最佳实践建议

1. 提交频率：建议每小时至少提交一次，避免单次提交包含过多变更。
2. 分支命名：使用type/scope格式（如feat/payment），保持团队统一。
3. 代码审查：通过Pull Request要求至少1名成员审核，使用git diff或GitHub的对比视图检查变更。
4. 自动化工具：集成Git Hooks（如pre-commit检查代码风格）或CI/CD流水线。

通过系统掌握上述内容，开发者可高效利用Git实现版本控制、协作开发与代码质量管理，为大型项目提供可靠的版本控制保障。