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

🕒 阅读时间：6 分钟📝 字数：831👀 阅读量：Loading...
查看 Markdown 原文

目录

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

一、Git 是什么

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

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

二、基本配置与初始化

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


# 初始化仓库
git init


# 查看状态
git status

三、核心操作：add / commit

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


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


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

四、回退与撤销

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


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


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


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

五、分支管理

Terminal window
# 查看分支
git branch


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


# 切换分支
git checkout main


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


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

六、远程仓库协作

Terminal window
# 关联远程仓库（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 标准流程

Terminal window
# 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

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

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

九、.gitignore 与规范提交

# .gitignore 忽略不该提交的文件
__pycache__/
*.pyc
.env
venv/
.idea/
.vscode/
# 提交信息规范（Conventional Commits）
feat: 新功能
fix: 修复bug
docs: 文档更新
refactor: 重构
test: 测试
chore: 杂项

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

Terminal window
# 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 是专业开发的必备技能，建议在真实项目中多加练习。

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

作者：Wang Shijie

本文链接：https://wsj-blog.pages.dev/posts/python-jin-jie-jiao-cheng-git-ban-ben-kong-zhi-yu-tuan-dui/

本文采用知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议进行许可。

Creative Commons

留言评论