第 2 小节：开源项目的源代码该怎么读

2022-08-16
浏览 (646)

第 2 小节：开源项目的源代码该怎么读

选择合适的项目

Gitee 上的项目种类和数量繁多，作为新手的话，要选择适合自己的项目进行学习。 1. 以实际项目为导向，可以是真正的工程项目，也可以是生活中实用的小项目，根据实际项目可以有方向性的选择开源项目； 2. 调查实际项目相关领域的常用开源项目，可以参考项目的活跃度(Gitee 指数)，贡献者数量，Star 数等缩小选择范围，学习过程可以获取更加丰富的资料； 3. 通过项目的 README.md 了解项目的大体情况，再进行研究和选择。

读源代码之前的准备工作

领域知识储备

开源项目往往是以领域知识为背景进行开发的，了解领域知识中基本概念、原理、算法，必然会降低阅读理解源码的难度。

善用学习工具

方便查找的 IDE 工具使源码阅读过程事半功倍，阅读源码要搞清楚函数之间的调用关系，IDE 拥有代码静态分析功能和便捷的断点调试功能，可以帮助你快速查看源码调用关系，整体了解源码的逻辑关系。类图工具，方便梳理、记录和可视化项目调用的逻辑关系，加快深入学习。

了解开源项目

查找和阅读该项目的官网、相关博客和资料，对项目的目的、功能、基本使用和代码组织结构进行大概的了解，进一步明确学习内容和目标。

读源代码时应该读些什么

读源代码的过程一般分为两步，首先是学习使用项目，对项目功能、运行环境和模块结构有基本的认识，搭建可以用于开发、调试和验证的环境；然后是阅读源代码，在运行环境中调试、梳理、深入理解代码细节，并尝试参与开源项目。

学习使用项目

阅读项目文档，如 getting started，example 等，学习如何开源项目下载、安装和基本使用方法；
如果项目提供 example 工程或者测试用例，尝试运行，解决运行过程中遇到的问题；
尝试根据理解和需要修改 example，通过调整各种参数观察表现结果，验证我们对项目的猜想和假设，加深对项目的认知；
在了解基本使用后，需要根据用户指南深入了解项目，例如项目的配置管理，高级功能及最佳实践；
如果时间允许，尝试从源码构建项目，根据项目构建指南，搭建一个可以用于开发、调试和验证的环境。

阅读项目源代码

阅读源代码的第一步为抓主干，尝试理清楚代码运行的调用路径，通过 Debug 来观察运行时的变量和行为，加入日志和打印可以更好的理解代码，大部分的细节需要在调试中理解；
画逻辑关系图帮助理解源码，将代码主干画成流程图或 UML 图，帮助记忆和下一步阅读，大幅度提高对框架的理解速度；
挑感兴趣的枝干代码来阅读，深入实现细节，包括使用的库、设计模式等；
重视单元测试，加深对程序模块功能的理解；
发现有可改进的地方，对项目开发者提出改进意见或者 Issue。
写笔记与写文章，通过写笔记记录学习的收获和经验，供以后使用，通过写文章对于问题进行深入和系统的思考。