Sparkle79's Field

如何开始自己的开源之路

2025/03/19
loading

第一次开源项目经历

一次机缘巧合的状况下,接触到了太乙平台
平台上会有一些开源竞赛
alt text

点击开源竞赛或推荐项目,可以了解一些自己感兴趣或擅长的比赛
alt text

如何去了解一个开源项目

对于开源项目来说,最权威的文档即官方文档,一般来说在项目的Github链接中都会有体现,特别是 readme.md 上的说明,以Spring AI Alibaba为例
Spring AI Alibaba readme
在官方文档中,我们至少可以了解一个项目解决的问题,一些比较大的项目还会包括项目的底层架构实现,以及一些使用样例等

Tips: 在进行项目贡献之前,至少要运行一下提供的样例,熟悉使用方式

如何去做出自己的贡献

使用期间发现的一些痛点或 bug

在接触并使用一段时间项目后,在这期间遇到了一些问题或痛点,主动进行bugfixadd feature

主动在项目 Issue 中寻找灵感

在 Github 界面的 Issue 中了解项目使用者遇到的一些问题,或在已经 close 的 Issue 中思考自己还能进行哪方面的贡献

针对问题进行代码开发

主要流程参考了博客:
如何提交自己的第一次PR


主要是以下几个关键步骤

  1. Fork 原项目到自己的 Github 仓库中
  2. 将 Fork 后的项目 clone 到本地
  3. 创建新分支,进行代码开发及测试
  4. 将本地的修改推送到 Fork 的远程仓库中
  5. 在原项目中提交一个PR,并针对该PR进行说明
  6. 等待PR审批通过后合并,或针对 Reviewer 提出的问题进行修改

万事开头难
如果上述步骤都没问题,那么恭喜你,成功的进行了一次开源贡献 ✨✨✨

浅浅纪念一下

alt text

alt text

CATALOG
  1. 1. 第一次开源项目经历
    1. 1.1. 如何去了解一个开源项目
    2. 1.2. 如何去做出自己的贡献
      1. 1.2.1. 使用期间发现的一些痛点或 bug
      2. 1.2.2. 主动在项目 Issue 中寻找灵感
      3. 1.2.3. 针对问题进行代码开发
    3. 1.3. 浅浅纪念一下