这些小活动你都参加了吗?快来围观一下吧!>>
电子产品世界 » 论坛首页 » 嵌入式开发 » MCU » 阅读源代码技巧

共4条 1/1 1 跳转至

阅读源代码技巧

菜鸟
2016-06-02 09:12:56     打赏

写代码是从模仿开始的,提高也是从观摩别人的优秀设计和代码开始的。所以阅读源代码至关重要,接下来赞从下列方面聊聊阅读源码的事情。

·目的

·工具

·知识准备

·运行与开发环境

·笔记

·实用技巧

·心理调试(散布在各个环节)

目的:

当我们阅读前面的源码时,无非有以下几种目的:

·纯粹学习

·添加新功能

·重构代码

·修复他人的Bug

不同的目的会有不同的心情,会影响到工作进度,像修复他人的Bug这种事情,类似于没有掰弯的男猿捏着鼻子给另一个男人擦屁股,是很恶心的,很容易让人拒绝的。所以因为这种目标而阅读源码,往往是欲拒还迎,欲说还休,效率低下。然而实际工作中帮人修复Bug这种事,十有八九你要遇到,无可逃避。所以,心里调试很重要。

为了学习去阅读源码,这是最愉快的也是最放松的。不过提醒一点,设定可检验的目标才会有收获,否则就像走在大街上看见一美女参见而过那样,惊艳一下下,过后嘛关系嘛收获也没有。

其他的目的,重构源代码、添加新功能,比帮他人擦屁股略强,因为它带有创造性,创造性的活动能给人带来强烈的愉悦,所以虽然这两种目的的也有很多让人不爽的部分,不过想到我可以让一棵老树焕发青春,不爽也就慢慢弱下去了。

工具:

工欲善其事必先利其器,这是更古不变的道理。要很好地完成阅读源码的任务,我们大概需要下列这些工具:

·SourceInsight,最好的开源浏览工具,它能维护符号库,动态显示上下文,还能绘制调用关系图,最好的,没有之一

·纸质笔记本,随时记录心得和疑惑,随时绘制各种图(类图、时序图、框图),比UML工具开,也比Visio

·中性笔

·记事本、notepad++、有道云笔记、为知笔记等,记录阅读源码过程中的关键点,心得体会,分析过程

·Visio,用于绘制简单的框图,标书源码的模块划分,层次结构等

·扫描全能王(CamScanner),一款可以通过拍照达到扫描效果的APP,可以用它扫描你的纸质笔记本上写的文字,绘制的框图,分享给其他人,如果你懒得用软件绘制图标,那手绘之后扫描成电子档就最适合你了

知识准备:

前戏很重要,准备好了后面水到渠成的快感不断,否则就会频频受挫直感道阻且长。

·业务基础,每一份有实际意义的源码都离不开业务,必须先对业务有概念

·技术基础,这个是源码用什么语言,什么框架,什么第三方模块,都需要先有所了解

·文档,尽量找到业务、需求、概要、详细等文档,帮助会很大,然后,我们经常面临的情况是,只有源码,只有源码,只有源码,片言只字的文档也无,所以只好坚信----源码是最好的文档。这个心理门槛其实也容易过,你就想象着源代码只是神仙姐姐的画像,看再多画像也不抵当面一眼效果强大——要么摧毁三观要么魂牵梦萦

·人,搞不明白那个程序员维护过这份代码,方便后面不懂时请教,又是人家点一下顶你自己瞎捉磨一天

运行与开发环境:

·配置好开发环境,目的是为了调试,对有些程序员来说,调试是弄明白软件内部机理的最好方法,按着F5F9F10F11,一切都搞定了

·配置好运行环境,为使用软件、体验软件准备,用户角度,从外面看看软件到底是怎么回事,便于揣摩内部逻辑

笔记:

在阅读源码的过程中,做笔记是必须的。我有这样的体会,因为代码不是自己写的,很难很快在脑子里刻下印记,经常看看这里忘了哪里,早上觉得弄懂了数据流向,中午吃个饭就忘了。所以,笔记就显得尤为重要。

·找到适合你的记录方式,小本本,软件皆可。用软件(Notepad++、有道笔记、为知笔记等)来记录有个坏处——必须切换屏幕,会在形式上中断代码阅读过程。所以我经常在紧张得不能中断时随手用笔记写一些残句断章在本子上,告一段落是梳理下用软件在记录。

·尽可能详细的记录,但不必看到什么记录什么,要间隔性的记录,比如弄明白了某个字模块的逻辑、某个类的作用、某个函数的调用关系时再记录,否则记录这个动作对打断思考

·每天工作结束,记录进度(弄明白的部分),记录疑问,记录第二天要弄明白什么东西,这样你的工作状态就入栈了,第二天来了很容易出栈,快速进入工作状态

·记录看到的优秀设计,提高审美,见贤思齐,自我成长

沧海遗珠:

我在漫长的读码生涯里积攒了一些的经验,算是碎碎念,供参考:

·理清某一业务如何映射在代码执行流程上的,这点很关键。

·理清不同模块间的业务关系,代码调用关系,很关键

·调试是弄明白代码调用流程的最快方式之一

·找出关键代码(代表实际对象的类,衔接不同模块的类,代表业务关键点的类)

·分析日志可以帮助分析源码执行流程和业务流程

·先用已有的可运行的软件,体验业务,琢磨你点这里一点哪里一下代码可能是做出怎么反应的

·阅读应该围绕目的,把实际目标放在第一位,比如修改Bug,如果有限期,在最后日期前搞定是第一要务,然后有时间就继续读源码或者改进Bug修复方案,力求没有副作用和后遗症,再有时间就修复别人留下的破窗户(你也可以顺带鄙视一下前任维护者)

·千万次的问,还记得前面说要弄明白谁谁维护过你要读的代码吧,别不好意思,问吧,问吧,问吧

·对着设计文档,接口文档或测试用例看代码

·心理调试,勿畏难,别放弃。有时间看代码,看两天也不知道个甚,一头雾水两眼发花是常有的事儿,有时真是觉得搞不定了,然而,这要么是你的基础知识没准备好,要么是你找借口,要知道,任何一份代码,都有一条隐形的线串着,耐心点,总会找到。这样不行那样,多换换角度,多换换方法,读不行就测试,测试不行就运行,运行不行就研究日志都不行,我靠,while(!i.isDead())i.analyzeCode(),跟Y死磕!总之,你不放弃自己,就没人能放弃你!

·给自己设置小奖励,弄明白某个逻辑或某个模块的代码后奖励自己休息一下,5-10分钟,走出办公室转转,或者干脆在网上瞎逛一下,浏览自己喜欢的网站

·读不懂才要读,想不明白才要想,这是进步和成长的开始。那些阻挡你的蹂躏你的而又杀不死你的,终将帮助你成长让你变得更强大。



专家
2016-06-02 10:25:36     打赏
2楼
沙发

专家
2016-06-02 13:02:53     打赏
3楼
SourceInsight的确是不错的选择。

工程师
2016-08-21 01:24:01     打赏
4楼
学习了,谢谢楼主

共4条 1/1 1 跳转至

回复

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