一些关于读代码和文档的问题

[xuewuzhijing_lc]

作为一个新人，读一个上万行的模块，老实说感觉很吃力，我目前在看高通平台的手机系统中的模块，麻烦有经验的高手指点下，最高效的读代码的方法，尽快的了解模块的逻辑，要注意什么，代码是用C写的。
还有是不是高手写代码就可以不写文档，一个模块几百个变量，之间的关系，蛮复杂的，太闷真的不写文档么，请告诉下我在自己着手写大量代码时要了解什么，要胸有成竹什么，毕竟一个模块的代码不是一个小程序。
谢谢各位的提点，注：我不是一个天才，请别给我说些没用的谢谢了！

[「已注销」]

学习学习

[surea]

学习中

[Tauren_Chieftan]

读代码之前，搞清楚程序结构和处理流程，必须辅以文档记录，
抽取关键结构体，仔细分析各个成员的含义。。。
然后看代码，从主任务开始看起。。。

感觉有些东西不好用文字描述。。。

[huanmie_09]

mark.

[soon]

看来楼主是搞嵌入式这一块的。嵌入式这一块与上层应用程序开发不同，有时候为了效率而放弃代码的可读性这是很正常的事。除非有相应的文档。否则很难看懂原代码。

比如果。循环展开。 ARM中无效立即数通过MVN来获取等。这些都是技巧很高的优化。如果没有设计文档。更本不知道。

所以还是先把文档看懂。

[yuzl32]

没文档的话，要理顺代码中的逻辑确实挺麻烦的。

[littlegeorge]

先了解代码所实现的功能和原理，然后有针对性的跟踪调试每个流程，由粗到细看。

[james_hw]

还记得刚开始工作时，前三个月全在走查代码，走查了5个模块，总共代码不下10w行，然后把逻辑关系理出来，写详细设计，并向模块作者汇报。。。哎，实际的代码和最初的详细设计已经有较大的出入，老员工懒的改详设，只好让新人来改。

不过效果不错，感觉从此以后设计能力大幅提升。

有技术文档的，根据技术文档走查，没有技术文档的，多问多上网。

走查过一个模块后，再看其他模块就有效率了。

[liujiaji]

1.选好工具：用Source Insight 3.5工具看。
2.会写文档，最好是excel.
3.你首先确认是多任务处理还是单任务处理，什么系统。系统中有什么API，功能是什么。
4.边看边花流程图和各个模块转换图。
5.最好能debug调试。

[田暗星]

确实很麻烦，没有头绪。

[ComputerMark]

不知道自己什么时候能接触到上万行的代码，菜鸟中。。。。。

[daxiao474]

learning

[LaoDong1982]

先找文档 了解基本架构
之后看大致流程

查Bug或者添加功能的时候再看细节

不要一开始就看细节，累并没有用

[lizzoe]

[Quote=引用 3 楼 imob419 的回复:]
单步调试，从main函数开始，第一遍不要单步到函数内，用笔记下来大体流程，第二遍，挑几个认为重要的函数进去看看，不要太深入细节，再用笔记下来，结合自己的分析再去看看感兴趣的代码。反复进行，每次就指定几个目标流程，慢慢的就熟悉了。
具体的技术实现可以不用太关注，只要清楚它的作用是什么就行，以后再细抠。
[/Quote]

呵呵，这样恐怕不行吧，这么大的规模，可不是什么一条线就能走到头的小程序，不好，不好。

其实还是关注业务吧。以特性或者功能入手，就像我们学习Linux内核一样，找本好书，然后一块一块的看，今天看内存管理，明天看任务调度。就像是盲人摸象，我们要先得其轮廓。
然后随着理解的深入，再去学习其精髓

[xuewuzhijing_lc]

多谢大家的建议，有收获，明天早上去结贴，谢谢了啊。

[bobo364]

嵌入式确实很复杂，里面不仅是程序，还有一些所谓的与硬件有关的数据，要想精通往往要学硬件的东西

[xuewuzhijing_lc]

我看的只是上层的应用，没有和硬件相关的。

[cattycat]

完全了解系统的流程确实很难，文档一般比较简单就是系统的大体流程和模块分类的，这种技术的文档一般是没有的。你可以看跟你相关的模块，然后自己写。一个函数几百个变量太多了吧。

[bladesoft]

一般成熟的系统会有design文档，只不过有没有发布出来，就不一定了；可读性好的代码，通过函数名称和参数就可以把函数功能了解个差不多，这也只是理想状态。
必要的话，自己还是要把重要函数细细看下，另外利用好函数注释，也会为你节省不少精力。

[赵4老师]

关键还是要有一个好的代码编辑器！