如何选择适合自己的开源项目以及如何阅读开源项目的源码

我会带着你远行 2022-11-21 03:37 214阅读 0赞

# 如何选择适合自己的开源项目 #

## 关键指标 ##

### 1. 技术栈 ###

首先要明白自己的技术栈是什么，使用什么语言或框架做开发。通过首页的关键字搜索，选择相对应的技术栈。其次要明白自己的水平，选择相对应水平的开源项目，能够更好的学习。对于项目的源代码，学习初期，可以不做深入的学习，只需要了解项目的大概架构。

### 2. Star 数量 ###

首页关键字搜索之后，一般来说会优先按照 Star 数量来排序，Star 数量高不代表一定是最好的，但起码说明这个项目的受欢迎程度，否则不会有那么多人 Star 这个项目 。在开源的项目上得一个 Star 远比在微信上获得一次「赞赏」难的多。

### 3. 项目作者 ###

Star 数量相差不多的情况下，可以看项目作者的影响力。有影响力的人不一定是最好的选择，但起码不会不靠谱。同时也可以看一下作者之前的作品，优秀且靠谱的作者，项目大多都是受人欢迎程度高的，可信赖的。当然，一般来说公司项目是优先于个人项目的，毕竟公司的开发实力是要强于个人的，同时公司的项目安全性，可靠性也是优于个人开发者的。

### 4. README.md ###

README.md 是关于项目的文档说明，在这个文件中会详细说明 **项目名及简介**，**项目背景**，**项目 Logo 和使用截图**，**项目的功能点**，**体验地址**，**如何下载这个项目**, **安装项目所需依赖** ， **如何安装** ， **如何部署** ，以及 **Debug 方法** 。通常来说，README.md 的详细程度和美观程度与该项目的靠谱程度成正比。

### 5. 项目的最后更新时间 ###

对于开源项目来说最怕的是作者不维护，这就意味着之后再也不会有改进了，并且出了问题也很难被迅速解决。项目的更新时间频繁，更新日期近，就意味着项目的作者还在维护。

### 6. Issues 和 Fork ###

Issues 数量多，作者回复速度快，Forks 数量多都是体现该项目被关注程度以及流行程度。

### 7. 开源协议 ###

使用开源项目也要遵守一定的原则的，即所谓的开源协议，常见的开源许可协议有：

GPL、LGPL、BSD、Apache Licence vesion 2.0、MIT。

这些协议不做过多解释。目前为止 MIT 应该算是用的最多的开源协议了，它的开放度最广，只要求基于此项目的项目也附带一份 MIT 协议即可（协议中有原作者的名字），也就是要求保留署名。通常来说，如果你的开源项目里面的源码没有任何所谓，只想专心写代码，附上一份 MIT 协议是最省心省力的选择。

### 8. 总结 ###

综合评估的指标下，选择一个相对来说成熟并且适合你自己的就好了。

--------------------

# 关于如何阅读开源项目的源码 #

> 学习各种开源项目，已经成为很多朋友不可回避的工作内容了。一个好的开源项目可以提高我们的开发效率，同时它也是一个很好的学习资源，参照大牛的编码风格和原理实现可以帮助我们养成良好的编码习惯，学习到优秀的代码实践。那么我们应该如何高效的学习开源项目呢？

大致思路就是先掌握基本的功能、原理和关键设计之后再去看源码—看源码的目的是为了学习其代码的写作方式以及关键技术的实现。

## 1. 学习分层和目标管理 ##

对于一个开源项目，可以将与之相关的各种知识和技能的学习大致划分为如下五个层次：

###### 第一层次：了解项目的基本概念、基本用途、逻辑结构、基本原理、产生背景、应用场景等基本知识。 ######

这个层次的基本定位就是“科普”。如果对于一个项目只需要有些基本了解，且短期内并不需要上手进行实际技术工作，则学习到这个层次也就可以先应付一下了。可以查找和阅读该项目的博客和资料，通过google你能找到某个项目大体介绍的博客，快速阅读一下就能对项目的目的、功能、基本使用有个大概的了解。

###### 第二层次：掌握项目的基本安装流程和使用方法。 ######

这个层次的基本定位是“入门”，以便对这个项目获得直观认识，对其安装和使用获得亲身体验。如果该项目有提供现成的 example 工程，首先尝试按照开始文档的介绍运行 example ，如果运行顺利，那么恭喜你顺利开了个好头;如果遇到问题，首先尝试在项目的 FAQ 等文档里查找答案，再次，可以将问题（例如异常信息）当成关键词去搜索，查找相关的解决办法，你遇到了，别人一般也会遇到，热心的朋友会记录下解决的过程;最后，可以将问题提交到项目的邮件列表，请大家帮你看看。在没有成功运行 example 之前，不要尝试修改 example。运行了第一个 example 之后，尝试根据你的理解和需要修 example，测试高级功能等。

通过安装和运行获取以下关键信息：

这个系统的依赖组件，而依赖的组件是系统设计和实现的基础  
安装目录也可以提供一些使用和运行的基本信息  
系统提供了哪些工具方便我们使用

需要特别关注命令行和配置文件，主要提供了两个关键信息，得以让我们窥视系统内部运行机制和原理：系统具备哪些能力，系统将会如何运行

###### 第三层次：了解代码的组织，找到各个主要逻辑/功能模块与代码文件之间的对应关系，通过代码分析走通几个关键的、有代表性的执行流程。 ######

这个层次的基本定位是“深入”，开始理解这个项目的实际实现，能够真正将项目的功能、工作原理和代码实现对应起来，获得对这个项目工作过程的直观认识。这个层次是学习开源项目代码的真正开始。如果希望基于这一项目进行应用开发，或者针对与这一项目密切相关的其他项目进行工作时，则对项目本身的代码进行这一层次的理解，会很有帮助。

###### 第四层次：了解该项目所有代码模块、程序文件的作用，走通所有主要执行流程。 ######

这个层次的基本定位是“掌握”，能够比较全面、系统地理解这个项目的设计和实现，并且熟悉项目各个部分的代码。如果希望对项目进行深度定制修改，或者对社区有所贡献，则应当以达到这个层次作为目标。专门针对原理进行系统性研究，主要体现在如下几个方面：

关键特性的基本实现原理
    优缺点对比分析

原理研究的手段：

通读项目的设计文档
    阅读网上已有的分析文档
    Demo 验证

###### 第五层次：钻研、领悟该项目的各种设计思想与代码实现细节。 ######

这个层次的基本定位是“精通”，精益求精，学无止境。这是大神们追求的境界。如果希望成为项目社区的重要贡献者乃至核心贡献者，则应当以这个层次作为努力的目标。

源码研究的主要目的是学习原理背后的具体编码如何实现，通过学习这些技巧来提升我们自己的技术能力。带着明确目的去研究源码，做到有的放矢，才能事半功倍，这也是源码研究要放在最后的原因。

> （1）阅读源码之前，查看该项目是否提供架构和设计文档，阅读这些文档可以了解该项目的大体设计和结构，读源码的时候不会无从下手。  
> （2）阅读源码之前，一定要能构建并运行该项目，有个直观感受。  
> （3）阅读源码的第一步是抓主干，尝试理清一次正常运行的代码调用路径，这可以通过debug来观察运行时的变量和行为。修改源码加入日志和打印可以帮助你更好的理解源码。  
> （4）适当画图来帮助你理解源码，在理清主干后，可以将整个流程画成一张流程图或者标准的UML图，帮助记忆和下一步的阅读。  
> （5）挑选感兴趣的“枝干”代码来阅读，比如你对网络通讯感兴趣，就阅读网络层的代码，深入到实现细节，如它用了什么库，采用了什么设计模式，为什么这样做等。如果可以，debug细节代码。  
> （6）阅读源码的时候，重视单元测试，尝试去运行单元测试，基本上一个好的单元测试会将该代码的功能和边界描述清楚。  
> （7）在熟悉源码后，发现有可以改进的地方，有精力、有意愿可以向该项目的开发者提出改进的意见或者issue，甚至帮他修复和实现，参与该项目的发展。

综上，对于一个开源项目的学习过程可以大致分为五个层次。至于到底要学习到什么阶段，投入多少相关精力，则完全取决于学习的目的。

## 2. 知识基础 ##

学习一个开源项目需要的知识基础主要包括：

1）该项目涉及的技术领域的背景知识  
如果没有背景知识作为基础，上来就死磕源代码，只能是事倍功半。

2） 该项目开发使用的语言及其各种开发调试工具  
巧妇难为无米之炊

3） 英语  
目前为止真正流行的开源项目大部分不是起源于国内。因此，除了学习个别极其流行、文档完备的项目之外，大家还是需要自行搜集阅读英文资料参考。学好英语很重要。

当然，到底需要准备多少知识基础，完全取决于学习的目的和层次。如果只是想科普一下，也就不必太过麻烦了。

## 3. 学习思路 ##

学习一个项目的过程，其实就是由表及里了解分析它的过程。上述提及的五个学习层次便组成了这样一个逐渐深入的过程。在此基础之上，学习、分析代码的过程，也可以尝试做到由表及里、逐渐深入。

在刚开始接触一个项目的时候，我们看到的其实就是一个黑盒子。根据文档，我们一定会发现盒子上具有若干对外接口。通常而言，这些接口可以被分为三类：

*  配置接口： 用于对盒子的工作模式、基本参数、扩展插件等等重要特性进行配置。这些配置往往是在盒子启动前一次性配好。在盒子的工作过程中，这些配置或者不变，或者只在少数的情况下发生改变。
 *  控制接口： 用于在盒子的工作过程中，对于一些重要的行为进行操纵。这是盒子的管理员对盒子进行控制命令注入和状态信息读取的通路。
 *  数据接口： 用于盒子在工作过程中读取外部数据，并在内部处理完成后向外输出数据。这是盒子的用户真正关心的数据通路。

因此，在分析一个开源项目的代码时，可以围绕重要的配置、控制、数据接口展开分析工作，特别应该注意理解一个关键的接口背后隐藏的操作流程。例如，针对数据接口，至少应当走通一条完整的数据输入输出流程，也即在代码中找到数据从输入接口进入盒子后，经过各种处理、转发步骤，最终从输出接口被传输出去的整个执行过程。一旦走通了这样一条流程，则可以将与数据处理相关的各个主要模块、主要步骤贯穿起来，并将逻辑模块图上和文档中的抽象概念对应到代码实现之中，可以有效推进对于项目的深入理解。

在实践这一思路的过程中，建议可以优先从控制接口和数据接口中各自选择一二重要者进行背后的执行流程详细分析，力争找到其中每一步的函数调用及数据传递关系（对于一些系统、应用库提供的底层函数可以先行跳过以节省时间）。这一工作完成之后，则第1节中第三层次的学习目标即可初步达成。

配置接口在不同的项目中的重要程度不同。对于一些架构极为灵活、配置空间甚大的项目，则可以适当多花些时间加以研究，否则简单了解即可。

## 4. 若干小建议 ##

1）**做好记录**  
刚刚入手学习某个项目的源代码时，其实很有点破译密码的感觉。大量的数据结构和函数方法散落在代码的各个角落里，等待着学习者将它们贯穿到一个个重要的执行流程中。因此，在分析学习的过程中，无论有什么零散收获，都值得认真记录下来。好记性不如烂笔头。

2）**不要过分纠缠于细节**  
立志搞懂一个项目的每行源代码是值得尊敬的，但至少在刚刚入手的时候是没有必要的。如果过于纠缠于代码的实现细节，则可能很快就被搞得头晕眼花不胜其烦了（看英文资料的时候，每遇到一个不认识的词都要立刻查词典么？）。不妨避免细节上的过度纠缠，还是先尽快走通关键的执行流程，将项目的骨干框架搭起来，然后再以此为参照，就可以清晰判断什么代码值得深入分析，什么地方可以简单略过了。

3）**想像和联想很重要**  
如前所述，从零开始搞懂一个项目的代码，就像破译密码。因此，不妨展开合理的想象和联想，将各个零散的发现和理解联系起来，并加以分析印证。在这个过程中，对项目所在领域的背景知识、对项目本身的逻辑框架和工作原理等方面的理解，都是想像和联想的参照与指导。此外，一些关键的函数名、变量名等等都是联想的hint。本质上，编程语言也是语言，而程序代码就是说明文。在分析代码时，一定要超越语言和代码的细节去理解被说明的事物本身。

4）**该搜就搜**  
分析代码的时候，很容易出现的情况就是，一个执行流程走到半截找不到下一步了，在这种情况下，当然首先还是推荐采用各种调试工具的单步执行功能加以跟踪。如果暂时不会，或者种种原因只能进行静态代码分析，那么该搜就搜吧。

参考文章：

> http://www.blogjava.net/killme2008/archive/2012/05/22/378885.html

> https://www.cnblogs.com/wangchengfeng/p/3659441.html