Git 完整实操教程：从初始化到 PR 合并，零基础团队代码管理全流程
前言不管是 AI 编程个人项目，还是多人协同开发，Git 是代码版本管理行业标准。很多新手直接在主分支改代码、一次性提交几十处改动，最后出现代码冲突、历史混乱、线上故障难以回滚等问题。本文结合 GitHub/Gitee 通用规范、企业 GitFlow 工作流，整理一套从新建项目、分支开发、提交规范、冲突处理到 PR 代码审核的完整实操流程，附带可直接复制命令，零基础开发者、AI 编程学习者均可一键套用。
一、Git 开发四大核心准则（避坑基础）
[*]分支开发，绝不直接操作 main 主分支
主分支仅存放稳定可上线代码，所有新功能、bug 修复全部新建独立分支开发。
[*]小步频繁提交
完成单个功能 / 修复单一 bug 就提交，禁止一次性大量无关改动打包提交，方便回滚、追溯问题。
[*]提交信息清晰规范
拒绝update、改代码等模糊描述，采用「类型 + 功能说明」统一格式。
[*]每日同步远程代码
开工、推送前拉取主干最新代码，大幅降低合并冲突概率。
二、两种项目初始化场景完整命令
场景 1：本地全新空白项目，关联远程仓库
bash
# 1. 创建项目文件夹并进入
mkdir ai-demo-project
cd ai-demo-project
# 2. 初始化本地Git仓库
git init
# 3. 新建说明文档
echo "# AI编程Demo项目" > README.md
# 4. 添加文件至暂存区
git add README.md
# 5. 首次提交
git commit -m "feat: 项目初始化，新增README"
# 6. 绑定远程仓库（替换你的仓库地址）
git remote add origin https://github/xxx/ai-demo-project.git
# 7 首次推送主线
git push -u origin main
场景 2：克隆线上已有仓库（最常用）
bash
# 克隆远程代码到本地
git clone https://gitee.com/xxx/ai-project.git
# 进入项目目录
cd ai-project
# 查看远程仓库绑定是否正常
git remote -v
# 每日开工第一步，拉取最新主干代码
git pull --rebase origin main
三、标准化分支体系与全套操作命令
1 分支类型命名规范（企业通用）
分支前缀用途示例
feature/新增业务功能feature/ai-chat-api
bugfix/开发阶段 bug 修复bug/login-param-fix
hotfix/线上紧急故障修复hotfix/server-crash
release/版本打包预发布release/v1.0.0
核心红线：main 分支只接收 PR 合并，不允许本地直接 commit、push。
2 分支增删切换常用命令
bash
# 查看全部本地分支
git branch
# 查看本地+远程所有分支
git branch -a
# 新建并切换到功能分支（新版git switch）
git switch -c feature/ai-code-gen
# 旧版切换创建分支
git checkout -b feature/ai-code-gen
# 单纯切换已有分支
git switch main
git checkout main
# 删除本地无用分支
git branch -d feature/old-test
# 强制删除未合并分支（慎用）
git branch -D feature/old-test
# 删除远程废弃分支
git push origin --delete feature/old-test
3 分支合并标准流程
[*]先切回主干 main，拉取最新代码
bash
git switch main
git pull --rebase origin main
[*]合并功能分支到本地主干
bash
git merge feature/ai-code-gen
[*]出现冲突按后文流程解决，无冲突直接推送
四、代码提交规范与进阶修改技巧
1 标准提交类型定义
[*]feat：新增功能
[*]fix：修复 bug
[*]docs：文档修改
[*]refactor：代码重构，无功能变化
[*]perf：性能优化
[*]test：补充单元测试
规范提交示例
bash
# 正确示范git commit -m "feat: 新增AI代码自动生成接口"git commit -m "fix: 修复参数空指针报错"# 禁止模糊提交git commit -m "更新代码"
2 提交后修改文案（未推送远程可用）
bash
# 修改上一次提交描述git commit --amend "feat: 新增AI代码自动生成接口，补充异常捕获"# 新增遗漏文件，不新增提交记录git add missing.pygit commit --amend --no-edit
五、拉取、推送与同步最佳实践
1 推送分支规则
bash
# 首次推送新分支，绑定远程关联git push -u origin feature/ai-code-gen# 后续同分支直接推送git push# 推送指定主干git push origin main
⚠️ 禁止在公共 main 分支使用git push --force强制推送，会覆盖团队他人代码，仅个人临时测试分支可谨慎使用。
2 每日同步推荐流程（大幅减少冲突）
bash
# 方案1：rebase变基（推荐，提交历史线性整洁）git pull --rebase origin main# 方案2：仅拉取不自动合并，手动处理git fetch origingit merge origin/main
完整每日开发循环：拉取主干→新建分支开发→频繁提交→推送分支→提交 PR 审核。
六、代码冲突完整解决步骤（新手高频痛点）
冲突产生原因
多人同时修改同一个文件同一行；本地未同步远程旧代码，直接提交推送。
冲突文件标记说明
plaintext
<<<<<<< HEAD当前分支（main）原有代码=======你功能分支新增代码>>>>>>> feature/ai-code-gen
标准五步解决流程
[*]执行git status查看全部冲突文件；
[*]用 VS Code/IDEA 打开冲突文件，删除<<<<<<< ======= >>>>>>>标记，保留正确业务代码；
[*]保存文件，标记冲突已解决
bash
git add 冲突文件名.py
[*]完成合并提交
bash
git commit -m "merge: 合并主干，解决接口参数冲突"
[*]继续推送分支提交 PR
冲突预防技巧
[*]每日开工先拉取主干最新代码；
[*]功能拆分细小，减少单文件大量修改；
[*]多人分工负责不同模块文件。
七、历史查看与代码撤销回退命令
1 查看提交日志
bash
# 完整日志git log# 简洁单行日志git log --oneline# 图形化分支关系git log --oneline --graph# 查看单个文件修改记录git log ai_code.py
2 撤销不同阶段修改
bash
# 撤销工作区未add的改动git restore ai_code.py# 撤销已add暂存，保留本地修改git restore --staged ai_code.py# 放弃最近一次本地提交（未推送远程）git reset --soft HEAD~1
八、团队协作 PR/MR 完整流程（GitHub/Gitee 通用）
PR 全称 Pull Request，是代码合并前强制审核流程，多人项目必不可少，防止 bug 直接合入主干。
[*]功能分支开发完成，执行推送
bash
git push -u feature/ai-code-gen
[*]打开仓库网页，点击「新建 Pull Request」；
[*]源分支选你的 feature 分支，目标分支选 main；
[*]PR 描述写明新增功能、修改点、测试结果，添加审核人；
[*]同事 Code Review，提出修改意见；
[*]本地根据反馈修改代码，再次提交推送，PR 自动同步更新；
[*]审核全部通过后，仓库管理员执行合并，合并完成后可删除本地 / 远程 feature 分支。
九、全文总结
整套 Git 标准化流程可概括为：初始化 / 克隆仓库→创建独立功能分支→小步规范提交→每日同步主干→冲突手动处理→推送分支提交 PR 审核→合并后清理废弃分支。
对于 AI 编程初学者、独立开发者，坚持分支隔离、规范提交两条核心习惯，就能规避 90% 代码混乱、线上回滚难、合并冲突等问题；多人团队务必严格执行 PR 代码审查机制，保障主干代码长期稳定，减少线上故障风险。
页:
[1]