阅读优秀代码是提高开发人员修为的一种捷径

简介: 导读:原文作者Alan Skorkin是一名软件开发人员,他在博客《Why I Love Reading Other People’s Code And You Should Too》中分享对软件开发相关的心得。

导读:原文作者Alan Skorkin是一名软件开发人员,他在博客《Why I Love Reading Other People’s Code And You Should Too》中分享对软件开发相关的心得。Alan认为:阅读优秀代码是提高开发人员修为的一种捷径。以下是全文:

我突然想起来,很多程序员都讨厌阅读代码。来吧,承认吧! 每个人都喜欢编写代码,编代码是件趣事。 另一方面,阅读代码也不容易。 不仅不容易(编注:参见《微软资深软件工程师:阅读代码不容易》),而且还非常枯燥,咱们要面对这一事实。任何不是你的代码都不怎样。(虽然我们没有说出来,但我们都是这样想的。) 即便是你自己几个小时之前写的代码,也会看起来很烂。时间越久,看起来越烂。 所以,为什么你要浪费时间去看其他人的糟糕代码,而你完全可以利用这段时间编写你自己的优秀代码。 其实我们可以一试,几个小时之后回头再看,看看你的代码是否还依旧优秀。 如果你不能吸收前辈大师的经验知识,那你永远都无法成为一位大师。 成为大师的方法之一是,找到一位大师,让其倾囊传授其所知。 有这种可能么?当然了,有这可能,虽然机会不大,但你必须极其走运。 不过你不必十分走运,因为我们幸运地处于这样一个职业,一个充满着大师知识和技能的职业,等待我们去汲取吸收,这些东西就在他们所编写的代码中。 你要做的就是去阅读代码,当然了,这或许耗时不少,毕竟没有人坐在那里给你讲解,但这种方法的成效还很高。 打个比方,要想成为一名卓越的木匠,得观察大量结构优良的家具。

我喜爱阅读代码,我的直觉告诉我,你也会从中获益颇丰。虽然阅读过程恼人并烦人,但其回报是非常值得你为之努力的。 说到这个,如果你想成为一名卓越的作家,你会专注于写作么? 你或许已经尝试,但你并没有走得很远。 大多数的伟大作家也是如饥似渴的读者,这是一个普遍事实。 在你能写出任何拿得出手的东西之前,你需要品读其他伟大作家,吸收不同的风格,看看前辈已尝试过的东西,从中吸取精华。 你的知识会慢慢增长,你自己的作品最终会透露出些许成熟,你也会找到一种“感觉”。 编写代码和写作没什么不同,如果你都没有阅读过任何卓越的代码,你为什么期望自己能写出像样的代码呢? 你显然不应该那样。对于程序员来说,阅读卓越代码就如同作家阅读优秀书籍一样重要(这话可不是我说的,这是Peter Norvig(Google研究院总监)说的,他非常优秀,大家也要向他学习了)。

即便所有这些都无法让你信服,那这里有一个不可置否的事实。 对你作为一名专业开发人员的生存来说,善于阅读代码至关重要。 如今,任何有一定规模的项目,都是团队的成果。所以,你通常要处理、修改和扩展大量不是你写的代码。 因此,阅读代码可能是你能掌握的最常用并最有用的技能。挺过这个难关,好好掌握。

如何阅读代码?像某些人一样……

我已经记不清有多少次看到程序员(用鼠标)滚上滚下地看着不熟悉的代码,几分钟过后,他们的脸上浮现出不悦的表情。 他们不久后会宣告说,那代码不值一读,为什么要浪费时间呢?我们只能用其他方法解决问题。 我不确定(他们)在期待什么,是通过潜移默化来吸收代码的含义,还是集中精神盯着代码来得到启发? 你不能只靠长时间盯着代码来阅读代码,你要理解它并化为己用。 这里有一些我喜欢用的技巧,虽然这不是一份详尽的列表,但我发现其中有些特别有用。

1. 尽力构建并运行代码。 这通常是一个简单的步骤,就像你在看可运行的代码(这和随机代码相反)。 不过,并非总是如此。通过构建和执行代码,你能从中学到很多上层代码结构。 说到工作代码,你是否非常熟悉如何构建你的当前项目? 虽然构建通常非常复杂,但通过构建并生成可执行的代码,你能学到很多。

2. 不要只注重细节。 你要做的第一件事是,在你正阅读的代码中,找到代码结构和风格的。 首先浏览一下代码,尽力理解不同代码段要做什么。这会让你熟整个代码的上层结构,你也能领会到你正处理的代码的一些构思(良好架构和意大利面条等)。 这时候,你可以找到切入点(不管它是什么,主函数、servlet或控制器等),并查看代码如何在那里分支。 不要在这上面花过多的时间,随着你愈加熟悉代码,你可以随时回来查看。

3. 确信自己理解所有结构。 除非你碰巧是所用编程语言的首席专家,否则该语言有些它能做的事你可能还不知道。当你在浏览代码时,记下所有你或许不熟悉的结构。 如果有很多不熟悉的结构,你要做的下一步非常明显。 如果你不知道代码要做什么,那你就走不了很远。 即便只有几个你不熟悉的结构,你应当深入查看。 你现在是在探索你所用编程语言中你以前不知道的东西,为此花几个小时来阅读代码,我也非常乐意。

4. 既然你对大多数结构已有很好了解,那现在是该做些随机深入研究了。 就像步骤2,开始浏览代码,当这次要挑选一些随机函数或类,并开始逐行详细查看。 这是硬仗开始的地方,但也是你要取得主要成功的地方。 这里的构想,会形成你正在查看的代码库的思维模式。 也不要在这上面花过长的时间,但在继续前行之前,你要尽力并极大吸收一些有内容的代码块。 这个步骤,你也可以随时反复回过头来,每次你都会了解更多的背景,并收获更多。

5. 毫无疑问,在前面这些步骤中,肯定有你困惑的地方,所以这是你做些测试的最佳时间。 在测试的时候,你的麻烦可能会更少,同时你也能理解代码。 我一直感到奇怪,开发人员忽略一套写得很好很全面的测试代码,而尽力去阅读并理解某些代码。 当然了,有时候并没有测试。

6. 如果你说没有测试,那这听起来是编写测试的时候了。 (编写测试)有很多益处,有助于你自己的理解,有助于你提升代码库,阅读代码时也能编写代码,这是该你出手做些事的时候。 即便已经有了测试,通常你也可以编写一些测试,你总能受益的。 测试代码通常需要换种方式思考问题,那些你以前不太明了的概念也会变得更清晰。

7. 提取奇特的代码,使其成为单独的程序。我发现阅读代码是个非常有趣的练习,即便只为节奏变化。 即便你不了解代码的底层细节,你或许能知道一些代码在上层结构上要做什么。 什么不提取一些特定的函数,单独列为独立的程序。 当你在执行小段程序时,调试也会更简单。反过来说,可能还需要一些额外的步骤,才能理解你正查看的代码。

8. 代码不干净?有异味?为什么不重构它?我并不建议你重写整个代码库,但重构部分代码,真的有助于你理解层次上升一层。 把你理解的函数拿出来,改成独立的函数。 在你知道之前,原来的大函数看起来易管理,你可以在脑海中修改它。 重构允许你把代码变成自己的,无需完成重写代码。 如果有好的测试,有助于重构,但即便你没有好的测试,抽取你确定的函数并做测试。 即便测试看起来完全不充分,但作为一个开发人员,你得学着相信你的技能,有时候你只需努力去做(重构)。(如果你必须重构,你通常都可以把代码恢复原状。)

9. 如果没什么能帮上忙,那你就找个阅读代码的同伴。或许并非只有你一个人能从这代码中获益,所以去找一个人,一起阅读代码吧。 但你别找专家,他们会从上层结构上,向你解释所有东西,你会错失那些你自己详细查看代码时所能学到的细微差别。 然而,如果不见效的话,你也不能理解,有时候,你能做的最好的事就是去问。 向你的同事请教,如果你正在阅读开源代码,可以在互联网上找人问问。 但是你要记住,这是最后一步,而不是第一步。

如果我时间紧迫,需要快速合理地理解某些代码,并且我只能挑选上述步骤的其中一个,那我会选择“重构”(即:第8个步骤)。 虽然你能理解的东西不会很多,但那些你领会的东西,你会牢牢记住的。 总之,有件事你需要记在心里。 如果你新接触一个重要的代码库,你不可能立即能理解它。 这需要数天、数周和数月的潜心努力,接受这个事实。 即便有一位专家和你在一起,也不能明显地缩短时间(。 然而,当涉及到代码库时,如果你能耐心并有条不紊地阅读(和编写)代码,你最终能熟悉项目的方方面面,你能成为大牛。 你或者是逃避阅读代码,经常寻求某人帮你讲解某事。 我知道我会成为哪一种人。

寻找阅读代码的机遇——不要错失

我们喜欢编写新代码,是因为我们这次能正确处理问题。 好吧,也许不是这次,但一定是下次。 事实上是,你经常改进你的技术,但你从没有恰当地处理问题。 这就是编写新代码的价值所在,你可以历练并磨练你的技能,但阅读和把玩其他人编写的代码,(如果没有更多的价值,)也是有同样多的价值。 你不仅能从中获得一些有价值的技术知识,也能收获领域知识,领域知识通常仍具更多价值(毕竟,代码是文档的最终形式)。

即便代码写得很神秘,无任何惯例可言,但还是有价值。 你知道我在说的代码,它几乎看起来晦涩难懂,但不是有意而为之(因某些原因,Perl语言代码通常是这样的)。 不管什么时候我看到那样的代码,我都会这样想: 把它想象成只有你破译它后才能学到的东西。 是的,这是主要的痛楚之处,但要接受它,有时候你自己也会因琐碎的原因而写出那种使人困惑的代码(否认没有用,你知道这是真的)。 好了,如果你花些时间来阅读那样的代码,你更有可能最终写出同样的代码。并不说你将会写出那样的代码,但你有能力写出那样的代码。 最后,态度通常是最重要的(编注:态度决定一切)。 如果你视阅读代码为日常繁琐的工作,那它就是(繁琐的工作),并且你会逃避,但如果你视其为一个机遇,那好事终将到来。

编者后话

你会经常去阅读优秀的开源代码么?欢迎在评论中和大家分享。

译文连接:http://www.jobbole.com/entry.php/471

原文链接:http://www.skorks.com

目录
相关文章
|
13天前
|
前端开发 JavaScript 测试技术
前端工程师的必修课:如何写出优雅、可维护的代码?
前端工程作为数字世界的门面,编写优雅、可维护的代码至关重要。本文从命名规范、模块化设计、注释与文档、遵循最佳实践四个方面,提供了提升代码质量的方法。通过清晰的命名、合理的模块划分、详细的注释和持续的学习,前端工程师可以写出高效且易于维护的代码,为项目的成功打下坚实基础。
27 2
|
20天前
|
算法 数据挖掘 程序员
从零开始的编程之旅:我是如何学会编写代码的
【10月更文挑战第30天】这篇文章将带你走进一个初学者的编程世界,从最初的迷茫与困惑,到最后的豁然开朗。我将分享我的学习经验,包括选择编程语言、理解基础概念、实践项目和解决问题的过程。无论你是编程新手还是有经验的开发者,这篇文章都会给你一些启示和鼓励,让你在编程的道路上更加坚定和自信。
编程中最难的就是命名?这几招教你快速上手(2)
编程中最难的就是命名?这几招教你快速上手
48 0
编程中最难的就是命名?这几招教你快速上手(2)
|
Java 程序员 编译器
编程中最难的就是命名?这几招教你快速上手(1)
编程中最难的就是命名?这几招教你快速上手(1)
80 0
编程中最难的就是命名?这几招教你快速上手(1)
|
关系型数据库
编程中最难的就是命名?这几招教你快速上手(3)
编程中最难的就是命名?这几招教你快速上手
55 0
|
JavaScript 程序员 API
程序员为什么会在开发中阅读源码?
作为程序员的大家想必都会在开发的时候,去阅读源码。在实际开发中,开发者经常需要阅读和理解源代码,阅读源码是一种非常有用的技能,它可以帮助程序员更好地了解代码、解决问题、学习新技术和提高编码能力。阅读源码的过程实质上是对软件构建技术和架构深度的一种持续学习和理解。阅读源码可以揭示代码的内在逻辑,这被看作是对技术深度理解的一种体现,它能提高我们对技术的理解程度。结合阅读《Node 中的 AsyncLocalStorage 的前世今生和未来》这篇文章之后,我深刻体会到了作为开发者阅读源码的重要性和必要性。通过阅读这篇文章,我对 AsyncLocalStorage 的实现原理和使用方式有了更深入的理解
231 3
程序员为什么会在开发中阅读源码?
|
SQL 运维 Java
如何用ChatGPT提高程序员开发效率?
如何用ChatGPT提高程序员开发效率?
548 0
|
敏捷开发 算法 Cloud Native
面试中的代码写作:如何撰写清晰、高效的示例代码
面试中的代码写作:如何撰写清晰、高效的示例代码
101 0
|
设计模式 新零售 供应链
一文教会你如何写复杂业务代码
这两天在看零售通商品域的代码。面对零售通如此复杂的业务场景,如何在架构和代码层面进行应对,是一个新课题。针对该命题,我进行了比较细致的思考和研究。结合实际的业务场景,我沉淀了一套“如何写复杂业务代码”的方法论,在此分享给大家。
28647 1
一文教会你如何写复杂业务代码
|
程序员
程序员如何做好代码重构?
代码重构重构就是在不改变软件系统外部行为的前提下,改善它的内部结构。重构不是重写,它们的区别你可以理解为,重构是修复代码,大框架不变。重写是扔掉原来的,重新设计框架。
213 0
程序员如何做好代码重构?
下一篇
无影云桌面