请遵循以下步骤,这是一个清晰、安全且专业的Git协作流程:
第1步:同步主分支最新状态
bash
# 1. 切换到主分支 (main 或 master) git checkout main # 2. 从远程仓库拉取最新更改,确保您的本地主分支是最新的 # (这步很重要,可以避免后续的合并冲突) git pull origin main
第2步:基于最新主分支创建并切换到新功能分支
bash
# 3. 创建新分支并立即切换过去 (这是推荐的一步到位操作) git checkout -b feature/your-feature-name # 例如: git checkout -b feature/add-user-login
最佳实践提示:给分支起一个描述性的名字,如 feature/xxx
, fix/xxx
, docs/xxx
,这样一眼就能看出分支的用途。
第3步:进行您的开发工作
现在您可以在项目文件夹中添加、修改、删除文件了。
第4步:提交更改到新分支
bash
# 4. 查看当前文件更改状态,确认是您要提交的内容 git status # 5. 将所有更改添加到暂存区 git add . # 或者添加特定文件: git add filename1.txt filename2.js # 6. 再次检查 status,确认暂存区的文件正确 git status # 7. 提交更改,并编写清晰明确的提交信息 git commit -m "feat: 添加用户登录功能"
提交信息规范提示:推荐使用类似 feat:
, fix:
, docs:
, style:
, refactor:
等前缀,让提交历史更清晰。
第5步:将新分支推送到远程仓库
bash
# 8. 将本地分支推送到远程仓库(GitHub) # 第一次推送时需要使用 -u 来建立追踪关系 git push -u origin feature/your-feature-name # 之后再次推送同一分支只需要 git push
第6步(重要):创建Pull Request (PR)
推送完成后,去GitHub仓库页面。
您通常会看到一个按钮提示比较分支并创建 Pull Request(或Merge Request)。
点击创建PR,填写标题和描述,请求将您的功能分支合并到
main
分支。等待代码审查(Code Review),根据反馈修改代码后,可以再次commit并push,PR会自动更新。
审查通过后,由您或项目维护者在GitHub上合并(Merge)PR。
流程总结图
图表
代码
给您的最重要建议
牢记分支切换:
git checkout -b branch-name
是创建并切换,是最常用的命令。确保您在正确的分支上操作(命令行提示符通常会显示当前分支名)。先拉取再创建:在创建新分支之前,先
git pull
更新主分支,这样可以基于最新的代码进行开发,减少冲突。使用PR/MR:不要直接往主分支(
main
/master
)上推送代码。通过Pull Request来合并代码是团队协作的标准做法,便于代码审查和CI/CD检查。