Git实战案例

1. 个人项目实践：小型网页开发

1.1 项目初始化

需求：开发一个包含首页、关于页的静态网页，使用Git管理版本。

# 创建项目目录并进入\mkdir personal-website && cd personal-website

# 初始化Git仓库
git init
                

1.2 开发与提交

创建index.html和about.html后，逐步提交关键版本：

# 跟踪所有文件
git add .

# 提交初始版本
git commit -m "完成首页基础结构"

# 开发关于页后再次提交
git add about.html
git commit -m "添加关于页基础内容"
                

1.3 版本回退演练

假设误删about.html内容，通过版本回退恢复：

# 查看提交历史找到最近正常版本的哈希
git log --oneline

# 回退到该版本
git reset --hard 6f4b321
                

2. 团队协作案例：多人开发管理系统

2.1 分支策略

采用Git Flow工作流：main（生产分支）、develop（开发分支）、feature/xxx（功能分支）。

# 开发者A创建功能分支
git checkout -b feature/login develop

# 开发者B创建另一功能分支
git checkout -b feature/search develop
                

2.2 解决合并冲突

两人同时修改header.html的导航栏，合并时出现冲突：

1. Git标记冲突区域：

   <<<<<<< HEAD
   <nav>登录入口</nav>
   =======
   <nav>搜索框</nav>
   >>>>>>> feature/search

2. 手动合并为：<nav>搜索框 | 登录入口</nav>
3. 提交解决冲突：git add header.html && git commit -m "解决导航栏冲突"

4. 版本发布与标签管理

4.1 场景说明

当项目完成一个重要功能迭代或修复关键bug后，需要标记当前稳定版本以便后续回溯。例如：发布v1.0正式版。

4.2 标签操作步骤

# 创建轻量标签（仅记录提交哈希）
git tag v1.0

# 创建带注释标签（推荐，包含版本说明）
git tag -a v1.0 -m "发布1.0正式版：新增用户认证功能" 

# 查看所有标签
git tag

# 查看指定标签详情
git show v1.0

# 推送标签到远程仓库
git push origin v1.0

# 检出标签版本（创建临时分支）
git checkout -b hotfix-v1.0 v1.0
                

4.3 实战演练

假设项目在main分支完成v1.0开发，需标记并推送标签：

1. 确认当前在main分支且代码已提交：git checkout main && git commit --allow-empty -m "准备发布v1.0"
2. 创建带注释标签：git tag -a v1.0 -m "正式发布1.0版本"
3. 推送标签到GitHub：git push origin v1.0
4. 后续若需修复v1.0的bug，从标签创建分支：git checkout -b fix-v1.0 v1.0

3. 开源项目贡献：参与Vue.js文档翻译

3.1 准备工作

在GitHub找到目标仓库（如vuejs/docs），点击"Fork"复制到个人账号。

3.2 本地开发

# 克隆个人Fork的仓库
git clone https://github.com/你的用户名/docs.git

# 添加上游仓库（原仓库）
git remote add upstream https://github.com/vuejs/docs.git

# 创建翻译分支
git checkout -b translate-zh
                

3.3 提交修改

完成翻译后推送并发起PR：

git push origin translate-zh
                

在GitHub个人仓库页面点击"New Pull Request"，选择目标分支（如main）并填写说明。