如何飞速成为开源贡献者Contributor

• 一、环境信息
• • 1.1 硬件信息
  • 1.2 软件信息
• 二、Git安装
• • 2.1 Git介绍
  • 2.2 Git下载安装
• 三、开源项目选定
• 四、GitHub参与开源流程
• • 4.1 Fork项目
  • 4.2 SSH配置
  • • 4.2.1 为什么要配置SSH
    • 4.2.2 如何配置SSH
  • 4.3 Clone项目
  • 4.4 IDEA关联
  • 4.5 PR生成
  • 4.6 PR提交

一、环境信息

1.1 硬件信息

1. 型号 ：MacBook Pro
2. 内存 ：16GB
3. 硬盘 ：512GB SSD
4. 处理器 ：Apple M2
5. 宿主机CPU架构 ：ARM

1.2 软件信息

1. Git版本 ：2.39.2 (Apple Git-143)
2. Maven版本 ：3.8.8
3. JDK版本 ：17

二、Git安装

2.1 Git介绍

Git 是一个分布式版本控制系统，用于管理和跟踪文件的变化。它可以帮助开发人员或团队追踪代码的修改历史、协同开发、管理各个版本的代码，并提供了回滚、分支管理、合并等功能。
使用 Git，开发人员可以在不同的分支上独立工作，然后将各自的修改合并到主分支上，以便保持代码的整洁和可维护性。Git 是开源的，易于安装和使用，因此被广泛应用于软件开发和其他版本控制的场景中。

2.2 Git下载安装

三、开源项目选定

Apache Doris 是一个基于 MPP 架构的高性能、实时的分析型数据库，以极速易用的特点被人们所熟知，仅需亚秒级响应时间即可返回海量数据下的查询结果，不仅可以支持高并发的点查询场景，也能支持高吞吐的复杂分析场景。
基于此，Apache Doris 能够较好的满足报表分析、即席查询、统一数仓构建、数据湖联邦查询加速等使用场景，用户可以在此之上构建用户行为分析、AB 实验平台、日志检索分析、用户画像分析、订单分析等应用。

四、GitHub参与开源流程

4.1 Fork项目

1.点击fork
2.创建fork

3.查看fork

4.2 SSH配置

4.2.1 为什么要配置SSH

git clone支持https和git（即ssh）两种方式下载源码：

当使用git方式下载时，如果没有配置过ssh key，则会报如下错误提示：

4.2.2 如何配置SSH

1.首先用如下命令（如未特别说明，所有命令均默认在Git Bash工具下执行）检查一下用户名和邮箱是否配置（github支持我们用用户名或邮箱登录）：

git config --global  --list 

# 如下图所示，说明还没配置

2.配置用户名和邮箱（如已配置则跳过）

# 可以在自己github的Settings中找到
git config --global  user.name "这里换上你的用户名"
git config --global user.email "这里换上你的邮箱"

3.再次检查用户名和邮箱（如已检查成功则跳过）

git config --global  --list 

# 如下图所示，说明配置成功

4.生成秘钥

# 执行命令后需要进行3次或4次确认(可以一路回车)
ssh-keygen -t rsa -C "这里换上你的邮箱"

# 结果如下图所示，记住红框内id_rsa.pub文件路径，后续需要配置到github上

5.打开你的github，进入Settings配置页

6.选择SSH and GPG keys项并新增

7.将id_rsa.pub的内容填入Key中并Add

4.3 Clone项目

git clone git@github.com:yz-jayhua/doris.git

4.4 IDEA关联

1.打开clone的项目

2.打开Settings并搜索git

3.点击测试让idea自动匹配并应用

4.5 PR生成

1.定位修改文件

2.从master新建一个分支去修改

3.分支命名并创建

4.创建后自动切换分支

5.提交代码到本地仓库

6.推送代码至github仓库上

7.PR生成确认

4.6 PR提交

1.点击【Compare & pull request】并创建PR

2.提交结果确认

至此，你已飞速成为开源贡献者(Contributor)啦～查阅过程中若遇到问题欢迎留言或私信交流。