引言

Git作为现代软件开发中不可或缺的版本控制工具，掌握其核心命令是每个开发者的必修课。本文将通过一个完整的项目流程，详细讲解如何在GitHub上使用Git进行分支管理、版本发布和代码合并。无论你是刚接触Git的新手，还是希望梳理操作流程的开发者，本文都将为你提供清晰的实践指南。

---

一、初始化项目与基础配置

1.1 克隆远程仓库

git clone https://github.com/your-username/your-repo.git
cd your-repo

替换your-username和your-repo为实际的GitHub账号和仓库名

1.2 查看当前分支状态

git status

该命令会显示当前所在分支（默认为main）及工作目录状态

---

二、创建与管理分支

2.1 从main分支创建新功能分支

git checkout -b feature/new-feature

或使用新版本Git的简化命令：

git switch -c feature/new-feature

feature/new-feature为自定义的分支名称，建议遵循feature/xxx命名规范

2.2 查看分支列表

git branch -a

-a参数会显示所有本地和远程分支

2.3 提交代码到新分支

git add .
git commit -m "Implement new feature"

2.4 推送分支到GitHub

git push -u origin feature/new-feature

-u参数会将本地分支与远程分支建立追踪关系

---

三、版本发布与标签管理

3.1 创建轻量标签（推荐用于简单版本标识）

git tag v1.0.0

3.2 创建附注标签（推荐用于正式发布）

git tag -a v1.0.0 -m "Release version 1.0.0"

-a参数创建带附注的标签，-m指定标签信息

3.3 推送标签到远程仓库

git push origin v1.0.0

若需推送所有标签：

git push --tags

3.4 查看标签信息

git show v1.0.0

---

四、代码合并与冲突解决

4.1 切换回main分支

git checkout main

4.2 拉取最新代码（避免合并冲突）

git pull origin main

4.3 合并功能分支到main

git merge feature/new-feature

冲突解决流程：

1. Git会提示冲突文件
2. 手动编辑冲突文件，保留需要的代码
3. 标记冲突已解决：

   git add <conflicted-file>
   

4. 完成合并：

   git commit
   

4.4 删除已合并的分支（可选）

git branch -d feature/new-feature

强制删除未合并的分支：

git branch -D feature/new-feature

---

五、GitHub操作补充

5.1 创建Pull Request（PR）

1. 登录GitHub仓库
2. 在Compare & pull request页面创建PR
3. 填写描述并提交
4. 等待代码审查后合并

5.2 查看标签详情

在GitHub仓库的Releases页面可查看所有tag信息

---

六、最佳实践建议

1. 分支策略：采用main（生产环境）和develop（开发环境）双分支模式
2. 标签规范：遵循语义化版本号（如v1.2.3）
3. 合并前检查：确保功能分支已通过CI/CD测试
4. 定期同步：定期从main拉取最新代码避免大冲突

---

结语

通过本文的实践流程，你已经掌握了Git的核心操作：分支创建、代码开发、版本发布和合并管理。建议在实际项目中多加练习，同时结合GitHub的图形化界面进行辅助操作。记住，良好的版本控制习惯能显著提升团队协作效率，让代码迭代更加安全可控。

提示：可通过git help或git <command> --help查看具体命令的详细文档