StarRocks GitHub 工作流程

StarRocks项目遵循GitHub工作流规范，其中包含若干实用建议（例如保持本地环境与上游仓库同步并及时提交）。本文档详细说明在GitHub平台完成StarRocks开发的完整工作流程。

第一步：云端分叉项目
访问：https://github.com/StarRocks/starrocks
点击右上角"Fork"按钮创建云端代码库分支

第二步：克隆分支至本地
点击Code > Clone获取仓库地址

bash

$ cd $working_dir  
$ git clone https://github.com/$user/starrocks

添加上游仓库关联：

bash

$ cd $working_dir/starrocks
$ git remote add upstream https://github.com/StarRocks/starrocks.git

使用以下命令验证远程仓库配置：

text

origin    https://github.com/$user/starrocks.git (fetch)
origin    https://github.com/$user/starrocks.git (push)
upstream  https://github.com/StarRocks/starrocks (fetch)
upstream  https://github.com/StarRocks/starrocks (push)

第三步：同步分支
确保本地分支与远程内容一致：

bash

$ cd $working_dir/starrocks
$ git checkout main
$ git fetch main
$ git rebase upstream/main
$ git push origin main 

第四步：创建开发分支
基于主分支创建新分支：

bash

$ git checkout -b myfeature

第五步：配置开发环境

• 配置前端(FE)开发环境

• 配置后端(BE)开发环境

第六步：修改内容或代码
在新创建的分支中进行内容或代码修改

第七步：提交更改
提交修改内容：

bash

$ git add <文件名>
$ git commit -m "提交说明"

如需多次修改提交，可参考以下命令：

bash

$ git add <文件名>          # 添加单个文件
$ git add -A               # 添加所有变更（新增/删除/修改）
$ git add -a -m "提交说明"  # 添加并提交修改和删除的文件
$ git add -u               # 添加修改和删除文件（不含新增）
$ git add .                # 添加新增和修改文件（不含删除）

第八步：推送更改
将变更推送到分叉仓库的远程分支：

bash

$ git push origin myfeature

第九步：发起拉取请求(PR)
访问您的分叉仓库 https://github.com/$user/starrocks
点击"Compare & pull request"按钮

第十步：评审与合并
PR提交后需经过至少2位评审人员确认，由StarRocks维护者在最终修改通过后完成合并

第十一步：等待CI验证
PR提交后将自动触发CI流程，必须通过所有必需检查项。若检查未通过，可点击"Details"链接查看详细信息