这些小活动你都参加了吗?快来围观一下吧!>>
电子产品世界 » 论坛首页 » 综合技术 » 基础知识 » 经验之谈:如何高效阅读项目代码?

共3条 1/1 1 跳转至

经验之谈:如何高效阅读项目代码?

高工
2023-11-27 10:25:43     打赏
最近有一位读者朋友问:刚参加工作,看不懂代码,怎么办?

今天就来简单分享一下,我个人看代码的几点经验。

1、了解项目整体架构

在阅读嵌入式代码之前,我们需要对项目整体架构有一个基本的了解。

公司里的项目,一般在做项目之前,都会进行系统设计、编写一些文档、画一些系统框图。可以先找这些项目资料看一看。

虽然我们后面可能只是负责某个模块,但是还是很有必要先了解这个项目的总体框架。

了解清楚整个项目有有哪些硬件模块、哪些软件模块、有哪些组件、各个模块之间的输入输出、各个模块是如何协同工作、项目的主体业务是什么、主要功能有哪些等。

嵌入式代码通常可以分解为几个关键模块,例如任务管理、内存管理、通信协议等。将各个模块分离出来,逐一阅读和理解,可以更加清晰地掌握代码的核心思想。

对项目整体架构有一定了解之后,有助于我们更好地理解代码中的逻辑。

2、熟悉通信部分代码

项目里一般会划分多个硬件/软件模块,这些模块之间会进行数据交互。

梳理清楚:

  • 使用了哪些硬件通信接口?例如I2C、SPI、UART等。
  • 线程通信?
  • 进程间通信?
  • 网络通信?
  • 协议数据处理?
  • 各个模块的数据分类?

我们可以先熟悉一下通信部分代码,梳理清楚各模块的交互。这一部分代码一般是比较容易看懂的,基本是看懂了一条数据之后,类似的基本就看懂了。基本看懂之后,可以跟着数据的流向,看看拿到这些数据之后,去做了什么处理。

因为你之后的工作,有可能是写这一部分代码。比如增加某个数据,要实现什么功能。

拿数据 + 做逻辑

3、阅读主业务模块

业务逻辑模块直接跟产品功能挂钩,看懂这个模块就可以很好地了解我们产品的功能。

业务逻辑作为最上层的模块,可能有好几个模块都对其提供一些接口。

阅读这一块代码需要注意的是:

  • 每个功能具体的函数实现可能会嵌套好多层的代码,刚开始千万不要一层一层点进去阅读、不要试图看懂每个函数、每行代码,不然只会越看越懵。

  • 我们在阅读这个模块的代码时,尽量沿着这个模块的主线去阅读,沿着主线尽可能快地弄清这个模块做的事情,理解函数调用关系。等我们弄懂本模块之后,日后对其它模块感兴趣再去仔细阅读其具体实现也不迟。

4、了解单元测试测试用例

一般项目里模块开发完成会编写一些单元测试用例进行自测。我们可以先不看单元测试模块是如何实现的,可以先看一些各个模块的测试用例,每个用例是如何跑的?输入?输出?

通过阅读这些测试用例,可以帮助我们快速地理解各个模块是如何触发的,以及一些接口的使用方法。

5、实践、分析日志

对代码有了一定理解之后,肯定也会带有很多困惑,这时候可以自己修改代码/增加一些调试日志来帮我们理解代码,有在线调试条件的可以进行在线调试。

同时,我们需要大致熟悉项目整体的日志:

  • 熟悉日志的格式。带有时间戳?带有模块标签?日志等级?

  • 了解应用程序启动日志,通过日志了解启动做了哪些工作、经过了哪些流程。

  • 了解一些关键日志。主业务的日志?

  • 跑跑一些用例,看看对应的日志。





关键词: 经验之谈     高效     阅读     代码    

专家
2023-11-27 16:38:03     打赏
2楼

让程序员完全做好文档,也要花很多精力。但这个精力是值得的。


院士
2023-11-28 15:35:02     打赏
3楼

谢谢分享的经验总结。


共3条 1/1 1 跳转至

回复

匿名不能发帖!请先 [ 登陆 注册 ]