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

55顶
4踩

2011-01-25 09:27 by 见习编辑 jobbole 评论(26) 有21448人浏览

敏捷开发

声明：ITeye资讯文章的版权属于ITeye网站所有，严禁任何网站转载本文，否则必将追究法律责任！

　　编者按：原文作者Alan Skorkin是一名软件开发人员，他在博客中分享对软件开发相关的心得，其中有很多优秀的文章，本文是其中的另一篇。Alan认为：阅读优秀代码是提高开发人员修为的一种捷径。以下是全文。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

　　编者后话

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

　　译文出处：伯乐在线 - 职场博客
　　译文链接：http://www.jobbole.com/entry.php/471

　　原文作者：Alan Skorkin　　编译：伯乐在线敏捷翻译组 - 关关

　　如需转载，但请注明原文/译文出处、译文超链接和译者等信息，否则视为侵权，谢谢合作！

来自: www.jobbole.com

分享到：

55
顶

4
踩

评论共 26 条请登录后发表评论

6 楼 yechw 2011-01-25 17:20

javaeye成了伯乐在线的分会场了？

5 楼 yidao620c 2011-01-25 16:40

AllenZhang 写道

foodyi 写道

哪位推荐一些经典的源代码

Junit

JUnit不大不小，比较适合阅读。

4 楼 AllenZhang 2011-01-25 12:16

foodyi 写道

哪位推荐一些经典的源代码

Junit

3 楼 foodyi 2011-01-25 11:59

哪位推荐一些经典的源代码

2 楼 BruceXX 2011-01-25 11:30

引用

但你有能力写出那样的代码。最后，态度通常是最重要的（编注：态度决定一切）。

比较赞同这句话

1 楼 chenjpu 2011-01-25 10:07

还比较多。

发表评论

您还没有登录,请您登录后再发表评论

相关推荐

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

Alan认为：阅读优秀代码是提高开发人员修为的一种捷径。以下是全文。我突然想起来，很多程序员都讨厌阅读代码。来吧，承认吧！每个人都喜欢编写代码，编代码是件趣事。另一方面，阅读代码也不容易。...

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

http://www.cnbeta.com/articles/133129.htm?1299690294注：《代码阅读方法与实践》(Code Reading: The Open Source Perspective)：http://www.verycd.com/topics/14267/原文作者Alan Skorkin是一名软件开发人员，...

《永磁无刷直流电机控制系统与软件综合研究-集成电机计算软件、电机控制器及电磁设计软件的创新设计与实践》,永磁无刷直流电机计算与控制软件：高效电机控制器与电磁设计工具,永磁无刷直流电机计算软件，电机控

《永磁无刷直流电机控制系统与软件综合研究——集成电机计算软件、电机控制器及电磁设计软件的创新设计与实践》,永磁无刷直流电机计算与控制软件：高效电机控制器与电磁设计工具,永磁无刷直流电机计算软件，电机控制器，无刷电机设计软件,电机电磁设计软件 ,永磁无刷直流电机计算软件; 电机控制器; 无刷电机设计软件; 电机电磁设计软件,无刷电机设计专家：永磁无刷直流电机计算与控制器设计软件

新能源汽车VCU开发模型及策略详解：从控制策略到软件设计全面解析,新能源汽车VCU开发模型及策略详解：从控制策略到软件设计全面解析,新能源汽车VCU开发模型及控制策略，MBD电控开发新能源汽车大势所

新能源汽车VCU开发模型及策略详解：从控制策略到软件设计全面解析,新能源汽车VCU开发模型及策略详解：从控制策略到软件设计全面解析,新能源汽车VCU开发模型及控制策略，MBD电控开发新能源汽车大势所向，紧缺VCU电控开发工程师，特别是涉及新能源三电系统，工资仅仅低于无人驾驶、智能驾驶岗位。 ——含控制策略模型整车控制策略详细文档通讯协议文档接口定义软件设计说明文档等（超详细，看懂VCU电控策略开发就通了）内容如下：新能源汽车整车控制器VCU学习模型，适用于初学者。 1、模型包含高压上下电，行驶模式管理，能量回馈，充电模式管理，附件管理，远程控制，诊断辅助功能。 2、软件说明书（控制策略说明书） 3、模型有部分中文注释对想着手或刚开始学习整车控制器自动代码生成或刚接触整车控制器有很大帮助。 ,新能源汽车VCU开发模型; 控制策略; MBD电控开发; 模型学习; 代码生成; 整车控制器; 能量回馈; 诊断辅助功能,新能源汽车电控开发详解：VCU控制策略模型及学习手册

Python读取Excel文件的方法详解及应用场景

内容概要：本文详细介绍了两种利用 Python 读取 Excel 文件的不同方法，分别是基于 pandas 和 openpyxl。对于想要利用Python 处理 Excel 数据的读者来说，文中不仅提供了简洁明了的具体代码片段以及执行效果展示，还针对每个库的应用特性进行了深度解析。此外，文档提到了一些进阶应用技巧如只读特定的工作薄、过滤某些列等，同时强调了需要注意的地方（像是路径设置、engine 参数调整之类），让读者可以在面对实际项目需求时做出更加明智的选择和技术选型。适合人群：对 Python 有基本掌握并希望提升数据读取能力的开发人员。使用场景及目标：适用于任何涉及到批量数据导入或是与 Excel 进行交互的业务流程。无论是做初步的数据探索还是深入挖掘隐藏于电子表格背后的故事，亦或是仅为了简化日常办公自动化任务都可以从中受益。最终目标帮助使用者熟悉两大主流 Excel 解决方案的技术特性和最佳实践。阅读建议：本文既是一份详尽的学习指南也是一份方便随时查阅的手册。因此初学者应当认真研究所提供的示例，而有一定经验者也可以快速定位到感兴趣的部分查看关键要点。

毕设springboot基于springboot的医护人员排班系统.zip

# 医护人员排班系统 ## 1. 项目介绍本系统是一个基于SpringBoot框架开发的医护人员排班管理系统,用于医院管理医护人员的排班、调班等工作。系统提供了完整的排班管理功能,包括科室管理、人员管理、排班规则配置、自动排班等功能。 ## 2. 系统功能模块 ### 2.1 基础信息管理 - 科室信息管理:维护医院各科室基本信息 - 医护人员管理:管理医生、护士等医护人员信息 - 排班类型管理:配置不同的排班类型(如:早班、中班、晚班等) ### 2.2 排班管理 - 排班规则配置:设置各科室排班规则 - 自动排班:根据规则自动生成排班计划 - 排班调整:手动调整排班计划 - 排班查询:查看各科室排班情况 ### 2.3 系统管理 - 用户管理:管理系统用户 - 角色权限:配置不同角色的操作权限 - 系统设置:管理系统基础配置 ## 3. 技术架构 ### 3.1 开发环境 - JDK 1.8 - Maven 3.6 - MySQL 5.7 - SpringBoot 2.2.2 ### 3.2 技术栈 - 后端框架:SpringBoot - 持久层:MyBatis-Plus - 数据库:MySQL - 前端框架:Vue.js - 权限管理:Spring Security ## 4. 数据库设计主要数据表: - 科室信息表(keshixinxi) - 医护人员表(yihurengyuan) - 排班类型表(paibanleixing) - 排班信息表(paibanxinxi) - 用户表(user) ## 5. 部署说明 ### 5.1 环境要求 - JDK 1.8+ - MySQL 5.7+ - Maven 3.6+ ### 5.2 部署步骤 1. 创建数据库并导入SQL脚本 2. 修改application.yml中的数据库配置 3. 执行maven打包命令:mvn clean package 4. 运行jar包:java -jar xxx.jar ## 6. 使用说明 ### 6.1 系统登录 - 管理员账号:admin - 初始密码:admin ### 6.2 基本操作流程 1. 维护基础信息(科室、人员等) 2. 配置排班规则 3. 生成排班计划 4. 查看和调整排班 ## 7. 注意事项 1. 首次使用请及时修改管理员密码 2. 定期备份数据库 3. 建议定期检查和优化排班规则

MATLAB仿真的夫琅禾费衍射强度图：圆孔、圆环、矩形孔定制研究,MATLAB仿真：夫琅禾费衍射强度图的可定制性-以圆孔、圆环及矩形孔为例的研究分析,MATLAB夫琅禾费衍射强度图仿真圆孔，圆环

MATLAB仿真的夫琅禾费衍射强度图：圆孔、圆环、矩形孔定制研究,MATLAB仿真：夫琅禾费衍射强度图的可定制性——以圆孔、圆环及矩形孔为例的研究分析,MATLAB夫琅禾费衍射强度图仿真圆孔，圆环，矩形孔可定制。 ,MATLAB; 夫琅禾费衍射; 强度图仿真; 圆孔; 圆环; 矩形孔; 可定制。,MATLAB仿真夫琅禾费衍射强度图：定制孔型（圆孔/圆环/矩形）

商道融绿ESG评级20241231.xlsx

详细介绍及样例数据：https://blog.csdn.net/samLi0620/article/details/145652300

基于Dugoff轮胎模型与B08-01基础建模的七自由度车辆动力学模型验证：利用MATLAB 2018及以上版本与CarSim 2020.0软件的仿真对比研究,基于Dugoff轮胎模型与B08-01框

基于Dugoff轮胎模型与B08_01基础建模的七自由度车辆动力学模型验证：利用MATLAB 2018及以上版本与CarSim 2020.0软件的仿真对比研究,基于Dugoff轮胎模型与B08_01框架的七自由度车辆动力学模型验证——使用MATLAB 2018及以上版本与CarSim 2020.0软件进行仿真对比研究,七自由度车辆动力学模型验证（Dugoff轮胎模型，B08_01基础上建模） 1.软件: MATLAB 2018以上；CarSim 2020.0 2.介绍: 基于Dugoff轮胎模型和车身动力学公式，搭建7DOF车辆动力学Simulink模型，对相关变量（质心侧偏角，横摆角速度，纵、横向速度及加速度）进行CarSim对比验证。 ,核心关键词：七自由度车辆动力学模型验证; Dugoff轮胎模型; B08_01建模基础; MATLAB 2018以上; CarSim 2020.0; Simulink模型; 变量对比验证。,基于Dugoff轮胎模型的七自由度车辆动力学模型验证与CarSim对比

【毕业设计】基于Java+servlet+jsp+css+js+mysql实现“转赚”二手交易平台_pgj.zip

【毕业设计】基于Java+servlet+jsp+css+js+mysql实现“转赚”二手交易平台_pgj

恋爱聊妹术V2小程序源码4.1.0多开版.zip

微猫恋爱聊妹术小程序源码介绍：微猫恋爱聊妹术小程序源码是一款全新升级的聊天工具，它采用全新主题和UI，完美支持分享朋友圈功能。同时，它的独立后台也进行了大规模更新，让操作更加简单。其中，课堂页面、搜索页面和子话术列表页面等，均增加了流量主展示，具有超多的功能。安装教程：您可以先加入微猫恋爱聊妹术小程序源码的赞助群，然后在群内找到魔方安装说明。根据源码编号找到相应的安装说明，非常详细，让您轻松完成安装。

电气安装工程安全技术规程-蒋凯，杨华甫，马仲范，王清禄译；孙照森校；鞍钢工程技术编委会编.pdf

电气安装工程安全技术规程_蒋凯，杨华甫，马仲范，王清禄译；孙照森校；鞍钢工程技术编委会编

基于Copula函数的风光空间相关性联合场景生成与K-means聚类削减MATLAB研究,基于Copula函数的风光空间相关性联合场景生成与K-means聚类削减算法研究,基于copula的风光联合场景生成?K-means聚类并削减 MATLAB 由于目前大多数研究的是不计风光出力之间的相关性影响，但是地理位置相近的风电机组和光伏机组具有极大的相关性。因此，采用 Copula 函数作为风电、光伏联合概率分布，生成风、光考虑空间相关性联合出力场景，在此基础上，基于Kmeans算法，分别对风光场景进行聚类，从而实现大规模场景的削减，削减到5个场景，最后得出每个场景的概率与每个对应场景相乘求和得到不确定性出力 ,基于Copula的风光联合场景生成; K-means聚类削减; 空间相关性; 概率分布; 场景削减,基于Copula与K-means的风光联合场景生成与削减研究

模块化多电平变流器MMC的VSG控制技术研究：基于MATLAB-Simulink的仿真分析与定制实现-支持三相与任意电平数,构网型模块化多电平变流器MMC的VSG控制策略与仿真模型：三相负荷变动下的

模块化多电平变流器MMC的VSG控制技术研究：基于MATLAB-Simulink的仿真分析与定制实现——支持三相与任意电平数,构网型模块化多电平变流器MMC的VSG控制策略与仿真模型：三相负荷变动下的虚拟同步发电机控制研究,构网型模块化多电平变流器 MMC 的VSG控制同步发电机控制 MATLAB–Simulink仿真模型，可按需求定制 10电平.14电平，任意电平可做。三相MMC，采用VSG控制。设置负荷变动，调整有功无功，保持电网电压和频率 ,构网型模块化多电平变流器; MMC的VSG控制; 虚拟同步发电机控制; MATLAB–Simulink仿真模型; 任意电平可做; 三相MMC; 负荷变动; 有功无功调整; 电网电压和频率保持。,基于VSG控制的模块化多电平变流器(MMC)的构网型仿真模型

暗通道算法DCP-Python实现

南师大实验室安全准入知识供学习

纯openMV寻迹小车.zip

【毕业设计】基于Java mvc架构开发的完整购物网站.zip

【毕业设计】基于Java mvc架构开发的完整购物网站

以下是针对初学者的 **51单片机入门教程**，内容涵盖基础概念、开发环境搭建、编程实践及常见应用示例，帮助你快速上手

以下是针对初学者的 **51单片机入门教程**，内容涵盖基础概念、开发环境搭建、编程实践及常见应用示例，帮助你快速上手。

55顶4踩