| title | permalink |
|---|---|
第 2 小节：开源项目的源代码该怎么读 |
/guide/chapter2/section-2 |
Gitee 上的项目种类和数量繁多，作为新手的话，要选择适合自己的项目进行学习。下面是我们建议你在寻找开源项目时可以考虑的地方：
- 以实际项目为导向，可以是工作中用到的真实项目，也可以是生活中遇到的实际需求，从中有方向性的选择可以解决问题的开源项目；
- 根据个人技术栈或者感兴趣的技术，从中筛选出一些符合你预期技术栈的开源项目；
- 分析开源项目的指标，例如项目的活跃度（Gitee 指数）、贡献者数量、Star 数、文档完整度、开发者社区等因素，建议初学者选择开发者较多、文档教程丰富的项目；
- 通过项目的 README.md 了解项目的大体情况，阅读使用手册、运行示例程序，再进行深入研究和选择，评估是否符合你的需求。
-
领域知识储备
开源项目往往是以领域知识为背景进行开发的，了解领域知识中基本概念、原理、算法，必然会降低阅读理解源码的难度。
-
善用学习工具
方便查找的 IDE 工具使源码阅读过程事半功倍，阅读源码要搞清楚函数之间的调用关系，IDE 拥有代码静态分析功能和便捷的断点调试功能，可以帮助你快速查看源码调用关系，整体了解源码的逻辑关系。类图工具，方便梳理、记录和可视化项目调用的逻辑关系，加快深入学习。
-
了解开源项目
查找和阅读该项目的官网、相关博客和资料，对项目的目的、功能、基本使用和代码组织结构进行大概的了解，进一步明确学习内容和目标。
读源代码的过程一般分为两步，首先是学习使用项目，对项目功能、运行环境和模块结构有基本的认识，搭建可以用于开发、调试和验证的环境；然后是阅读源代码，在运行环境中调试、梳理、深入理解代码细节，并尝试参与开源项目。
- 阅读项目文档，如 getting started，example 等，学习如何开源项目下载、安装和基本使用方法；
- 如果项目提供 example 工程或者测试用例，尝试运行，解决运行过程中遇到的问题；
- 尝试根据理解和需要修改 example，通过调整各种参数观察表现结果，验证我们对项目的猜想和假设，加深对项目的认知；
- 在了解基本使用后，需要根据用户指南深入了解项目，例如项目的配置管理，高级功能及最佳实践；
- 如果时间允许，尝试从源码构建项目，根据项目构建指南，搭建一个可以用于开发、调试和验证的环境。
- 阅读源代码的第一步为抓主干，尝试理清楚代码运行的调用路径，通过 Debug 来观察运行时的变量和行为，加入日志和打印可以更好的理解代码，大部分的细节需要在调试中理解；
- 画逻辑关系图帮助理解源码，将代码主干画成流程图或 UML 图，帮助记忆和下一步阅读，大幅度提高对框架的理解速度；
- 挑感兴趣的枝干代码来阅读，深入实现细节，包括使用的库、设计模式等；
- 重视单元测试，加深对程序模块功能的理解；
- 发现有可改进的地方，对项目开发者提出改进意见或者 Issue。
- 写笔记与写文章，通过写笔记记录学习的收获和经验，供以后使用，通过写文章对于问题进行深入和系统的思考。
千羽、xiangshang、雪山凌狐、张翠山、Apache DolphinScheduler 社区、WhitePaper、taotieren、阿基米东
发现内容中的错误？还是想要补充更多符合主题的内容？《开源指北》欢迎你进行贡献，点击贡献指南了解贡献的具体步骤。