如何阅读别人的代码

简介:

代码阅读的必要性

       阅读别人的代码作为开发人员是一件经常要做的事情。一个是学习新的编程语言的时候,通过阅读别人的代码是一个最好的学习方法,另外是积累编程经验。如果你有机会阅读一些操作系统的代码会帮助你理解操作系统一些基本的原理。还有就是在你作为一个质量保证人员或一个小领导的时候,如果你要做白盒测试的时候没有阅读代码的能力是不能完成相应的任务。最后一个就是如果你中途接手一个项目的时候或给一个项目做售后服务的时候是要有阅读代码的能力的。


收集所有可能收集的材料

       阅读代码要做的第一件事情是收集所有和项目相关的资料。比如你要做一个项目的售后服务,那么你首先要搞明白项目做什么用的,那么调研文档、概要设计文档、详细设计文档、测试文档、使用手册都是你要最先搞到手的。如果你是为了学习,那么尽量收集和你的学习有关的资料,比如你想学习linux的文件系统的代码,那么最好要找到linux的使用手册、以及文件系统设计的方法、数据结构的说明等资料。(这些资料在书店和网上都可以找到)。


材料的种类

1、基础资料

       比如你阅读turbo c2的源代码,你应该准备turbo c2的函数手册,使用手册等专业书籍,如果是msc 6.0或者java ,此时不但要有函数手册,还要有类库函数手册。这些资料都是你的基础资料。另外你要有一些关于uml的资料可以作为查询手册也是一个不错的选择

2、和程序相关的专业资料

       每一个程序都是和相关行业相关的。比如我阅读过一个关于气象分析方面的代码,因为里边用到了一个复杂的数据转换公式,所以不得不把自己的大学时候课本找出来 来复习一下高等数学的内容。如果你想阅读linux的文件管理的代码,那么找一本讲解linux文件系统的书对你的帮助会很大。

3、相关项目的文档资料

       这一部分的资料分为两种,一个是相关行业的资料,比如你要阅读一个税务系统的代码,那么有一些财务/税务系统的专业资料和国家的相关的法律、法规的资料是必不可少的。此外就是关于这个项目的需求分析报告、概要设计报告、详细设计报告,使用手册、测试报告等,尽量多收集对你以后的代码阅读是很重要的


知识准备

       了解基础知识,不要上来就阅读源代码,打好基础可以做到事半功倍的效果

留备份,构造可运行的环境

       代码拿到手之后的第一件事情是先做备份,最好是刻在一个光盘上,在代码阅读的时候一点不动代码是很困难的一件事情,特别是你要做一些修改性或增强性维护的时候。而一旦做修改就可能发生问题,到时候要恢复是经常发生的事情,如果你不能很好的使用版本控制软件,那么先留一个备份是一个最起码的要求了。

在做完备份之后最好给自己构造一个可运行的环境,当然可能会很麻烦,但可运行代码和不可运行的代码阅读起来难度会差很多的。所以多用一点时间搭建一个环境是很值得的,而且我们阅读代码主要是为了修改其中的问题或做移植操作。不能运行的代码除了可以学到一些技术以外,用处有限。

找开始的地方

       做什么事情都要知道从哪里开始,读程序也不例外。在c语言里,首先要找到main()函数,然后逐层去阅读,其他的程序无论是vbdelphi都要首先找到程序头,否则你是很难分析清楚程序的层次关系。

分层次阅读

       在阅读代码的时候不要一头就扎下去,这样往往容易只见树木不见森林,阅读代码比较好的方法有一点象二叉树的广度优先的遍历。在程序主体一般会比较简单,调用的函数会比较少,根据函数的名字以及层次关系一般可以确定每一个函数的大致用途,将你的理解作为注解写在这些函数的边上。当然很难一次就将全部注解都写正确,有时候甚至可能是你猜测的结果,不过没有关系这些注解在阅读过程是不断修正的,直到你全部理解了代码为止。一般来说采用逐层阅读的方法可以是你系统的理解保持在一个正确的方向上。避免一下子扎入到细节的问题上。在分层次阅读的时候要注意一个问题,就是将系统的函数和开发人员编写代码区分开。在c, c++java ,delphi中都有自己的系统函数,不要去阅读这些系统函数,除非你要学习他们的编程方法,否则只会浪费你的时间。将系统函数表示出来,注明它们的作用即可,区分系统函数和自编函数有几个方法,一个是系统函数的编程风格一般会比较好,而自编的函数的编程风格一般比较会比较差。从变量名、行之间的缩进、注解等方面一般可以分辨出来,另外一个是象msc6++会在你编程的时候给你生成一大堆文件出来,其中有很多文件是你用不到了,可以根据文件名来区分一下哪些是系统函数,最后如果你实在确定不了,那就用开发系统的帮助系统去查一下函数名,对一下参数等来确定即可。

写注解

       写注解是在阅读代码中最重要的一个步骤,在我们阅读的源代码一般来说是我们不熟悉的系统,阅读别人的代码一般会有几个问题:1.搞明白别人的编程思想不是一件很容易的事情,即使你知道这段程序的思路的时候也是一样。2.阅读 代码的时候代码量一般会比较大,如果不及时写注解往往会造成读明白了后面忘了前面的现象。3.阅读代码的时候难免会出现理解错误,如果没有写注解很难及时地发现这些错误。4.不写注解经常导致忘记函数的特性,如它的功能是什么,从而经常会发生重复阅读、理解的现象。

       好了,说一些写注解的基本方法:

       1.猜测地去写,刚开始阅读一份源代码的时候,你很难一下子就确定所有的函数的功能,不妨采用猜测的方法去写注解,根据函数的名字、位置写一个大致的注解,当然一般会有错误,但你的注解实际是动态调整的,直到最后你理解了全部代码。

       2.按功能去写,别把注解写成语法说明书,千万别看到 fopen就写“打开文件”,看到fread就写“读数据”,这样的注解一点用处都没有,而应该写“在此处打开参数配置文件(****.conf),读取系统初始化参数......”。这样才是有用的注解。

       3.在写注解的同时,另外要注意的一个问题是分清楚系统自动生成的代码和用户自己开发的代码,一般来说没有必要写系统自动生成的代码。像delphi的代码,我们往往要自己编写一些自己的代码段,还要对一些系统自动生成的代码段进行修改,这些代码在阅读过程是要写注解的,但有一些没有修改过的自动生成的代码就没有必要写注解了。

       4.对于主要代码段,较为详细的注解是必要的。有一些函数或类在程序中起关键的作用,那么要写比较详细的注解。这样对于理解代码有很大的帮助。

       5.理解起来比较困难的地方,要写详细的注解,在这些地方往往会有一些编程的技巧。不理解这些编程技巧对你以后的理解或移植会有问题。

       6.写中文注解。如果你的英文足够的好,不用看这条了,但很多的人英文实在不怎么样,那就写中文注解吧,我们写注解是为了加快自己的理解速度。中文在大多数的时候比英文更适应中国人。与其写一些谁也看不懂的英文注解还不如不写。

重复阅读

       一次就可以将所有的代码都阅读明白的人是没有的。至少我还没有遇到过。反复的去阅读同一段代码有助于得代码的理解。一般来说,在第一次阅读代码的时候,你可以跳过很多一时不明白的代码段,只写一些简单的注解,在以后的重复阅读过程中,你对代码的理解会比上一次理解得更深刻,这样你可以修改那些注解错误的地方以及上一次没有理解的对方。一般来说,对代码阅读34次基本可以理解代码的含义和作用。

运行并修改代码

       如果你的代码是可运行的,那么先让它运行起来,用单步跟踪的方法来阅读代码,会提高你的代码速度。代码通过中间变量了解代码的含义,而且对以后的修改会提供很大的帮助

目录
相关文章
|
大数据
如何快速阅读
如何快速阅读
79 0
|
6月前
|
NoSQL Java 应用服务中间件
关于阅读源码
【1月更文挑战第12天】关于阅读源码
|
12月前
|
设计模式 JavaScript 前端开发
|
缓存 算法 安全
程序员写代码为什么要阅读源码?
阅读一篇技术文章,畅聊一个技术话题。本期文章推荐的是《Node 中的 AsyncLocalStorage 的前世今生和未来》,一起来聊聊开发者阅读源码的这件事。阅读源码的过程实质上是对软件构建技术和架构深度的一种持续学习和理解。阅读源码可以揭示代码的内在逻辑,可以对技术深度的理解,也能提高对技术的理解程度。然而,仅仅阅读源码并不能代替实践操作,因为通过实践,可以更加全面的理解代码的深度和进展。
146 1
|
人工智能 运维 Kubernetes
2022阅读总结
2022年阅读总结,推荐今年看过的不错的书籍。
255 0
2022阅读总结
|
设计模式 分布式计算 资源调度
如何阅读源码
如何阅读源码
208 0
|
前端开发 算法 JavaScript
我喜欢这样阅读一本书
  每年各大电商都会推出图书满减活动,每次我都会屯些书,然而在以前,这些书买了后经常放在书架上吃灰,给自己的理由就是没时间看。现在想想是自己当时看的方法不对,由于对每本书都是事无巨细无差别的从头开始一篇篇的看,看的时候也不注意笔记,因此经常是读了后面的忘了前面的,读完整本书,能记得的内容寥寥无几。平时如果用不到的话,等于是白读了,久而久之,就越来越不喜欢阅读书籍了,但屯书的习惯倒没变。
我喜欢这样阅读一本书
|
机器学习/深度学习
Sorry About That, Chief!(阅读理解题)
题目描述 When Dr. Orooji was your age, one of the popular TV shows was “Get Smart!” The main character in this show (Maxwell Smart, a secret agent) had a few phrases; we used one such phrase for the title of this problem and we’ll use couple more in the output description!
140 0
|
编译器 C语言 数据安全/隐私保护
C++day12笔记无代码
C++day12笔记
332 0
|
分布式计算 搜索推荐 前端开发
学会阅读源码后,我觉得自己better了
学会阅读源码后,我觉得自己better了
182 0

相关实验场景

更多