一、基本命令1. git init作用在当前目录下初始化一个全新的空 Git 仓库生成隐藏的 .git 文件夹。用法git init执行完后当前文件夹就从普通目录变成了 Git 可以管理的代码仓库后续操作基于这个初始化环境。2. git add作用把工作区修改过的文件添加到 Git 的暂存区为下一次提交做准备。用法添加单个指定文件git add 文件名.py添加当前目录下所有新文件夹和修改过的文件git add .添加指定目录下的所有内容git add src/3. git commit作用把暂存区里所有已经 add 的内容正式保存到本地 Git 仓库中生成一条带唯一标识的提交记录永久写入版本历史。用法直接附带提交说明git commit -m 完成xxxx不带 -m 参数会打开文本编辑器要写详细提交说明后保存退出git commit4. git push作用把本地仓库的新提交同步上传到远程的 Git 仓库GitHub、Gitee、GitLab让远程服务器和本地保持一致。用法第一次推送当前分支时指定远程仓库和分支名git push -u origin main后续推送当前分支的新提交直接执行就行git push注意推送前要确保本地分支的提交历史和远程分支没有冲突否则 Git 会拒绝推送需要先拉取远程最新代码合并后再尝试推送。5. git pull作用从远程仓库下载最新的提交记录并且自动把远程的新代码合并到你当前的本地分支里相当于「git fetch git merge」的组合操作。用法拉取当前分支对应的远程分支的最新代码并自动合并git pull使用场景多人协作开发时每次开始写新代码前先执行一次 git pull就能拿到团队其他人刚提交的最新代码避免后续提交时出现大量冲突。二、分支、合并、变基1. 分支概念是一个指向具体提交的可变轻量指针。作用从主线分出多条开发线并行互不干扰。用法git branch feature-login # 创建分支 git checkout feature-login # 切换分支或 git switch feature-login git checkout -b feature-login # 创建并切换 git branch -d feature-login # 删除已合并的分支2. 合并概念将两个分支的开发历史整合到一起的操作但并不会修改已有的提交记录。类型快进合并Fast-forward目标分支没有新提交直接移动指针不产生合并提交。三方合并两边都有新提交产生一个合并提交merge commit有两个父提交。用法git checkout main git merge feature-login冲突处理git add 冲突文件 git commit使用场景功能开发完成后把 feature 分支合回 main。把 main 的最新改动合进自己的功能分支保持同步。团队约定保留完整历史、需要看到“何时合并了什么”时。3. 变基概念/作用把当前分支从分叉点开始的所有提交全部提取出来放到目标分支的最新提交之后。用法git checkout feature-login git rebase main这会把 feature-login 上独有的提交搬到 main 最新提交之后。使用场景功能分支开发中想同步 main 的最新改动又不想产生一堆合并提交。提交历史太乱想整理成干净的提交再合并。本地提交尚未推送想修改提交信息或合并零碎提交。黄金法则不要对已经推送到共享远程仓库的提交做变基。三、团队协作规范Issue 和 PR规范唯一主责人原则每一个模块、每一项任务只能指定 1 名最终负责人协作人可以有多个但最终结果的出口必须唯一避免多人决策导致的效率内耗。五要素对齐原则所有分工必须明确回答 5 个问题最终交付物是什么、谁是唯一主责人、需要谁提供什么输入、责任人拥有什么决策权限、完成的验收标准是什么。角色边界清晰原则以通用研发团队为例各核心角色的责任边界要明确划分。Issue用来记录 Bug、需求、任务方便团队沟通。填写规范1. Bug 类 Issue 必填项清晰的标题[模块名] 点击登录按钮无响应复现步骤一步步写清楚怎么操作能 100% 复现问题实际结果当前操作后出现的错误现象预期结果正常情况下应该出现的正确效果环境信息浏览器版本、系统版本、项目版本号2. 新功能类 Issue 必填项清晰的标题[用户中心] 新增头像上传功能功能背景为什么要做这个功能解决什么问题功能细节核心交互逻辑、边界场景说明验收标准满足什么条件才算这个功能开发完成PR在改完代码后发起一个合并请求让团队负责人审核代码审核通过后才会合并到主分支。填写规范规范标题使用类型: 简短描述改动内容的格式改动说明详细描述本次 PR 做了什么改动解决了什么问题对应关联的 Issue 编号自测说明写清楚自己做了哪些场景的测试附上测试截图或者测试结果变更清单列出本次改动涉及的所有文件和核心改动点方便审核人快速定位重点