Git 完整实操教程：从初始化到 PR 合并，零基础团队代码管理全流程

接好运鸭 · 发表于 2026-8-4 09:52:24

前言

不管是 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 代码审查机制，保障主干代码长期稳定，减少线上故障风险。

Git 完整实操教程：从初始化到 PR 合并，零基础团队代码管理全流程

浏览过的版块