Python进阶教程：Git版本控制与团队协作

目录

• Python进阶教程：Git版本控制与团队协作
• • [一、Git 是什么](#一、Git 是什么)
  • 二、基本配置与初始化
  • [三、核心操作：add / commit](#三、核心操作：add / commit)
  • 四、回退与撤销
  • 五、分支管理
  • 六、远程仓库协作
  • 七、团队协作工作流
  • • [7.1 常用工作流](#7.1 常用工作流)
    • [7.2 标准流程](#7.2 标准流程)
  • 八、解决冲突
  • [九、.gitignore 与规范提交](#九、.gitignore 与规范提交)
  • 十、实战：发布第一个开源项目
  • 总结

Python进阶教程：Git版本控制与团队协作

本文是 Python 入门教程系列 的第 19 篇（扩展篇）。Git 是程序员必备技能，本篇讲解 Git 的核心概念与常用操作，以及团队协作工作流。

一、Git 是什么

Git 是一个分布式版本控制系统，能记录每次代码修改，支持回溯、分支和多人协作：

• 版本回溯：随时回到任意历史版本
• 分支管理：并行开发互不影响
• 团队协作：多人同时开发同一项目

二、基本配置与初始化

# 全局配置（只需一次）
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

# 初始化仓库
git init

# 查看状态
git status

三、核心操作：add / commit

# 将文件加入暂存区
git add main.py
git add .          # 添加所有文件

# 提交到版本库
git commit -m "添加主程序"

# 查看提交历史
git log --oneline
# 2f4b148 添加主程序
# c6a96bf 初始化项目

四、回退与撤销

# 撤销暂存区的修改
git reset HEAD main.py

# 丢弃工作区修改（危险！）
git checkout -- main.py

# 回退到上一个版本
git reset --hard HEAD~1

# 查看所有操作记录（找回误删）
git reflog

五、分支管理

# 查看分支
git branch

# 创建并切换分支
git checkout -b feature-login

# 切换分支
git checkout main

# 合并分支（先切回目标分支）
git merge feature-login

# 删除分支
git branch -d feature-login

六、远程仓库协作

# 关联远程仓库（GitHub / Gitee / GitLab）
git remote add origin https://github.com/user/repo.git

# 推送代码
git push -u origin main

# 拉取代码
git pull origin main

# 克隆项目
git clone https://github.com/user/repo.git

七、团队协作工作流

7.1 常用工作流

main（稳定版）
 └── develop（开发版）
      ├── feature/登录功能
      ├── feature/支付功能
      └── fix/修复bug-123

7.2 标准流程

# 1. 拉取最新代码
git pull

# 2. 创建功能分支
git checkout -b feature/new-feature

# 3. 开发并提交
git add .
git commit -m "feat: 新增功能"

# 4. 拉取主干最新（避免冲突）
git pull origin main

# 5. 合并回主干
git checkout main
git merge feature/new-feature

# 6. 推送
git push origin main

八、解决冲突

多人修改同一文件会产生冲突，需手动解决：

<<<<<<< HEAD
你写的代码
=======
别人写的代码
>>>>>>> feature-branch

处理方式：保留需要的部分，删掉 <<<<<<<、=======、>>>>>>> 标记，然后重新提交：

git add 冲突文件.py
git commit -m "解决冲突"

九、.gitignore 与规范提交

# .gitignore 忽略不该提交的文件
__pycache__/
*.pyc
.env
venv/
.idea/
.vscode/

# 提交信息规范（Conventional Commits）
feat: 新功能
fix: 修复bug
docs: 文档更新
refactor: 重构
test: 测试
chore: 杂项

十、实战：发布第一个开源项目

# 1. 初始化并提交
git init
git add .
git commit -m "feat: 初始版本"

# 2. 在 GitHub 创建空仓库，然后关联
git remote add origin https://github.com/用户名/项目名.git
git push -u origin main

# 3. 打标签发版本
git tag v1.0.0
git push origin v1.0.0

# 4. 编写 README.md 说明项目
# 项目名
# 简介、安装方法、使用示例、许可证

总结

本篇介绍了 Git 的核心操作（add/commit/分支/合并/远程）、团队协作工作流、冲突解决和提交规范。熟练使用 Git 是专业开发的必备技能，建议在真实项目中多加练习。