如何提交 Pull Request (PR)

简介

Pull Request（PR）是开源社区中贡献者向项目官方代码库提交修改代码，请求采纳的标准流程。以下是详细步骤：

一、注册账号并签署 CLA

注册 Gitee 账号并设置提交邮箱

1. 注册 Gitee 账号
   Gitee 官网注册账号
2. 设置提交邮箱
   进入 "设置 → 邮箱管理" 配置提交邮箱

签署个人 CLA

• CLA 简介
  贡献者许可协议，提交 PR 前必须签署
• 签署要求
  签署邮箱需与 Gitee 提交邮箱一致

二、准备 Git 环境

安装 Git

• 官方安装
  Git 官网下载安装
• 其他方式
  • Windows：通过 VirtualBox 安装 Linux 系统
  • Linux/macOS：命令行直接使用
  • 云环境：华为云 ECS 使用 Git

配置 Git 账号

git config --global user.name "你的Gitee-ID"
git config --global user.email "你的提交邮箱"
git config --global --list  # 验证配置

三、准备代码

Fork 仓库到个人账号

1. Fork 操作
   点击仓库页面右上角 "fork" 按钮
2. Clone 到本地

git clone https://gitee.com/你的Gitee-ID/仓库名.git
cd 仓库名

创建开发分支

git switch -c dev  # 创建并切换到dev分支

修改代码

• 进入修改目录

cd ./playground/primary.pr/

• 创建标识文件

touch 你的Gitee-ID  # 创建空文件

• 提交修改

git add 你的Gitee-ID
git commit -s -m "Add a new file"

• 推送到远程仓库

git push --set-upstream origin dev

四、提交 PR

创建 Pull Request

1. 进入 Gitee 仓库
   • 切换到 "dev" 分支
   • 点击 "Pull Requests → New Pull Request"
2. 配置分支
   • Base: 上游仓库 master 分支
   • Compare: 你的 dev 分支

填写 PR 信息

• 标题格式
  你的Gitee-ID - 修改说明
• 注释内容
  说明修改原因及具体变更

提交 PR

点击 "Create" 按钮提交，成功后在官方仓库 PR 页面可见

实验结果

实验感想

通过本次 PR 提交实践，我深刻体会到开源协作的魅力。从注册账号到代码提交，每个环节都需要严谨操作。清晰的 PR 描述能极大提高审核效率。这次实践我不仅掌握了技术流程，也增强了动手能力，为今后参与更多开源项目奠定了坚实基础。