资讯频道 → 编程语言
阅读更多

30顶
3踩

编程语言

翻译新闻 编写好代码的10条戒律

2011-07-18 15:36 by 见习编辑 jobbole 评论(23) 有14815人浏览
编程 代码

　　1. DRY: 不要重复你自己（Don’t repeat yourself）

　　DRY是一条最容易理解但又是相对比较难以应用的原则。它是指当你在两处或者更多的地方发现相似代码时，我们应当把它们抽象成一个新的函数，在之前重复的地方调用新的函数并带上适当的参数。

　　DRY也许是最普遍的一条编程原则，我从未发现一个开发人员认为编写重复的代码是件好事。但是我发现一些开发人员在编写单元测试时忘记了这条原则，例如：设想一下你改变了一个类的接口，之前已经为这个类编写了很多的单元测试，如果你没有应用DRY原则，这时你需要手动去修改所有使用这个类接口的调用，来与每一个测试实例的新签名匹配。


　　2. 编写短小的函数/方法

　　有三个非常好的理由，选择编写短小的函数。

  • 1. 代码会更容易阅读。
  • 2. 代码会更容易重用（短小的函数更容易产生松耦合）。
  • 3. 代码会更易于测试。


　　编者注：松耦合：在软件领域中，“耦合”一般指软件组件之间的依赖程度。耦合度松的软件会有较好的扩展性。


　　3. 给类、函数和变量使用好的命名

　　直接使用其他开发者的代码而不需要阅读说明文档，没有什么比这更好的事情了，因为代码中的类名、函数名已经能够告诉我们所有需要的信息。所以，采用这种方法，每次在为你的代码中任何元素进行命名的之前请花上几秒钟（思考），这会让大家的生活变得更轻松。


　　4. 为每个类分配正确的职责

　　一个类只承担一个职责（单一权责），听起来和有些人知道的SOLID原则很相似，但是这里不是指任意的职责，而是正确的职责。所以，如果我们要设计一个顾客类，我们不会给它创建一个销售的行为，我们只会让它处理所有与一个客户相关的数据。

　　编者注：SOLID：面向对象设计的五项原则 （是SRP单一职责原则、OCP开闭原则、LSP李式代换原则、ISP依赖反转原则和 DIP接口分离原则，首字符的缩写)。


　　5. 保持代码的条理性

　　代码条理性分两个层次

  • 物理上的条理性：无论你采用了哪种结构，包、命名空间、文件夹等等，用一种更容易并且凭直觉就能找到代码存放在哪里的方式来组织你编写的类。
  • 逻辑上的条理性：不论逻辑上从属关系如何，（只要有逻辑从属关系）类都应该能够互相访问彼此的成员变量，但是如果从属于不同的逻辑结构就应当只能通过接口来访问。这种逻辑分组通常会被实现成（逻辑）层、服务等。


　　6. 编写很多的单元测试

　　测试越多越好，它们是所有代码变动的安全保证，我们会在将来的某一天需要运行这些测试代码。


　　7. 尽早且经常地重构代码（Refactor often and sooner）

　　软件开发是一个持续发现的过程，为了编写保持与新增/改变的需求匹配的高质量代码，随着开发的进行，重构代码是必不可少的。由于重构是一项带有风险的任务，需要有两个主要的前提条件，来避免由于重构给系统引入新的错误。

  • 1. 编写很多的单元测试
  • 2. 每一次重构的幅度要比较小。在开发软件过程中，开始重构2000行代码，3个小时以后发现所有的代码都不能工作，并且导致问题的原因无从查找，因此需要恢复到最初版本，几乎没什么事能比这更让人抓狂了。


　　8. 注释是恶魔

　　这条特殊戒律有一点争议，我们大多数人学到的是“注释是一个好的习惯”，并且在一段晦涩的代码中有一段注释会比仅仅只有代码好的多，这里我的观点是：给晦涩的代码加注释还不如仅仅留下代码，只需要重构这段代码直到它变得可读为止。（编注：当然了，除了作者说的这种类型的代码，在其他情况下，还是得添加必要的注释，这不仅方便自己日后查看，更有利于后来者维护，请参阅《提高代码可读性的10个注释技巧 》一文。


　　9. 要面向接口编程，不要面向实现编程（Code to an interface, not to an implementation）

　　这是一条经典的原则，面向接口编程会让我们从实现的细节中解放出来，我们只要定义一个协议，并且依据协议调用定义的操作，期望（对方，即被调用的代码）能把实际的实现或者运行时态的实现传递给我们的代码。


　　10. 对代码进行复查

　　我们都会犯错误，没有什么能比请别人对我们代码做一个非正式快速复查更好的办法来查找错误了。最好不要等到代码都完成以后再复查，当某些重要部分的代码完成后，或者离上一次复查相隔几天之后，就进行复查。


　　原文：Alberto Gutierrez　　　翻译：伯乐在线 敏捷翻译 - 唐尤华

来自: www.jobbole.com
30
顶
3
踩
评论 共 23 条 请登录后发表评论
23 楼 雪飘寒 2011-11-09 11:11
aystnd 写道
LubinJava 写道
什么是面向对象编程,
在天朝,一切都是面向现实编程.

文章是讨论如何写好代码，你非要扯上其他的，有牢骚不要在这里抱怨，抱怨只能说明你这人不是个纯粹做技术的。


看了一下，理论上都是正确的，很好，不过实际中就不是这么回事了，什么东西都要联系实际。
人家怎么怎么叫扯到别的上面了，人家说的是实话，是实际，总比空谈这些理论好吧。
22 楼 aystnd 2011-07-25 11:08
LubinJava 写道
什么是面向对象编程,
在天朝,一切都是面向现实编程.

文章是讨论如何写好代码，你非要扯上其他的，有牢骚不要在这里抱怨，抱怨只能说明你这人不是个纯粹做技术的。
21 楼 taolei0628 2011-07-23 10:55
我很少写注释，但我认为这是我做得不好的地方。
代码能写到不用注释就能读懂？太不现实了。

引用8楼的看法：
第8条有什么想不通的，干净的代码无需太多注释，每一个类名，每一个函数名，每一个对齐的格式，本身就是最好的注释。只有垃圾代码，才靠大量注释来解释其含义，并且难改，也容易出bug，更严重的是：有时候你代码改了，注释没改，这样反而会引起误解！

程序写的烂不是注释的错。按你的理解，JDK的源代码就是烂的不能再烂的代码了。
20 楼 hellolaojiang 2011-07-20 13:19
LubinJava 写道
什么是面向对象编程,
在天朝,一切都是面向现实编程.

   
19 楼 LubinJava 2011-07-20 09:55
什么是面向对象编程,
在天朝,一切都是面向现实编程.
18 楼 lvhjean 2011-07-20 08:13
同意 17楼 的观点 工作中 一大部分都是做 面向现实的
17 楼 boyuliu 2011-07-19 21:42
公司大部分代码都是面向现实， 每天被细节所引发出的问题而煎熬着
16 楼 别惹Java 2011-07-19 20:08
单元测试不怎么写
15 楼 jiushiyouke 2011-07-19 18:29
《重构》+《代码整洁之道》的总结
14 楼 walkintojava 2011-07-19 17:37
注释可以用方法名，类名，　以及代码本来来代替。
13 楼 lyzhanghai 2011-07-19 17:03
骨之灵魂 写道
说的不错。
第8条的意思是 当你认为加上注释才能让别人理解这段代码时，说明这段代码需要重构了。

《重构》的那本书上就是这么写的
12 楼 geminiyellow 2011-07-19 15:30
spring
11 楼 骨之灵魂 2011-07-19 12:37
说的不错。
第8条的意思是 当你认为加上注释才能让别人理解这段代码时，说明这段代码需要重构了。
10 楼 parchingo 2011-07-19 11:29
作为一个初学者来说，我的代码总是有点乱，想到哪里就写到哪里，看了这东西后相当有感触，谢谢分享！
9 楼 微雨心晴 2011-07-19 10:23
第八条严格来讲是正确的！但这个正确是有条件的！初学者一定要注意被误导！
完整解释在我的微博上，就不写了：http://weibo.com/sharedata
8 楼 niva 2011-07-19 10:16
第8条有什么想不通的，干净的代码无需太多注释，每一个类名，每一个函数名，每一个对齐的格式，本身就是最好的注释。只有垃圾代码，才靠大量注释来解释其含义，并且难改，也容易出bug，更严重的是：有时候你代码改了，注释没改，这样反而会引起误解！
7 楼 smilebomb 2011-07-19 09:49
唉，第8条，让人想不通，本人持有相反的意见
6 楼 yjc2020 2011-07-19 09:16
注释写的明白就有用，否则没神马用
5 楼 liu.anxin 2011-07-19 08:46
看过一些人写的注释, 敷衍的那种. 看老半天不知道注释上写的到底什么意思, 具体的还得去看代码.
4 楼 allenny 2011-07-19 03:15
不同意注释那一条

发表评论

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

相关推荐

  • 分布式计算的基本原理

    分布式计算的基本原理 转载时请注明出处：http://blog.csdn.net/absurd 从最近几次MMI设计会议讨论的结果来看，嵌入式程序员对于分布式计算知之甚少。他们对分布式计算有种恐惧，所以对分布式架构极力排斥。而他们的人数又占绝对优势，讨论N次，MMI的架构还是没有确定下来。分布式计算已经进入桌面环境，不是企业应用的专利了，像GNOME(GNU Network Objec...

  • 分布式计算 ——原理、算法与系统（Distributed Computing —— Principles, Algorithms, and System）读书笔记 持续更新

    分布式计算 ——原理、算法与系统 Distributed Computing —— Principles, Algorithms, and System 不定期更新   第一章 引言 第二章 分布式计算模型   第一章 引言 分布式系统：处理器、存储器、通信网络 1.4 与并行多处理器/多计算机系统的关系 并行系统：通过将计算任务在多个处理器之间进行分配，从而获得...

  • 分布式技术原理（七）：分布式计算

    目录 分布式计算 什么是分而治之？ 分治法的原理 MapReduce 工作原理 MapReduce 实践应用 总结 分布式计算模式之Stream Stream 工作原理 分布式计算 Hadoop 这个框架主要用于解决海量数据的计算问题。那么，它是如何做到海量数据计算的呢？你可能会想，既然是海量数据，规模这么大，那就分成多个进程，每个进程计算一部分，然后汇总一下结果，就可以提升运算速度了。其实，整个计算流程，我们可以很形象地用一个词来解释，就是“同流合污“，在分布式领域中就叫作 MR 模式

  • 分布式系统设计系列 -- 基本原理及高可用策略

    分布式系统设计系列之 -- 基本原理及高可用策略篇 这篇文章主要介绍一些入门的概念和原理，后面带来一些高可用、数据分布的实践方法！

  • 编写好的代码的10条戒律

    1. DRY: 不要重复你自己（Don’t repeat yourself） 　DRY是一条最容易理解但又是相对...　DRY也许是最普遍的一条编程原则，我从未发现一个开发人员认为编写重复的代码是件好事。但是我发现一些开发人员在编写单

  • 基于改进YOLOv5s的森林烟火检测算法.pdf

    基于改进YOLOv5s的森林烟火检测算法.pdf

  • 人力资源管理工具绩效考核excel模板01.xlsx

    人力资源管理工具绩效考核excel模板01

  • 施工班组长绩效考核表.xls

    施工班组长绩效考核表

  • 57 -营业部经理绩效考核表1.xlsx

    57 -营业部经理绩效考核表1

  • XX公司行政部绩效考核指标.xls

    XX公司行政部绩效考核指标

  • ant-apache-xalan2-1.9.4-2.el7.x64-86.rpm.tar.gz

    1、文件内容：ant-apache-xalan2-1.9.4-2.el7.rpm以及相关依赖 2、文件形式：tar.gz压缩包 3、安装指令： #Step1、解压 tar -zxvf /mnt/data/output/ant-apache-xalan2-1.9.4-2.el7.tar.gz #Step2、进入解压后的目录，执行安装 sudo rpm -ivh *.rpm 4、安装指导：私信博主，全程指导安装

  • 部门绩效考核表模板（基于KPI以月度为例2）.xlsx

    部门绩效考核表模板（基于KPI以月度为例2）

  • 11-6-质检员绩效考核表（含自动计算、等级评价及任意设置等级）.xlsx

    11-6-质检员绩效考核表（含自动计算、等级评价及任意设置等级）

  • 2024年最新全国河流、湖泊矢量数据(数据权威)

    2024最新全国河流湖泊矢量数据 【数据介绍】 2024年中国河流湖泊数据 一份包含中国境内所有主要河流和湖泊的地理信息数据。 数据格式：Shapefile：广泛使用的GIS数据格式，方便在各类GIS软件中使用。 数据获取：访问OpenStreetMap官网，通过导出工具选择中国区域并下载所需的数据。 使用Geofabrik等第三方网站，可以下载预处理好的中国区域的OSM数据。 数据使用：GIS软件：如QGIS、ArcGIS等，用户可以在这些软件中导入OSM数据进行可视化、分析和编辑。 数据应用： 环境研究：分析河流湖泊的水质变化，研究水资源分布及其环境影响。 城市规划：用于规划城市水系、洪水防控、水资源管理等。 导航和旅游：为河流湖泊的导航和旅游路线规划提供数据支持。 科研：为水文地理研究、生态保护、气候变化等领域提供基础数据。 数据特点： 实时更新：OSM数据由全球用户贡献，具有较高的实时性和更新频率。 开放性：所有数据都在开放许可下发布，允许用户自由使用、修改和分发。 详细性：由于全球志愿者的不断努力，数据细节较为丰富，涵盖了从主要河流湖泊到小型水体的广泛范围。 数据时间2024年5月，shp格式，数据来源OpenStreetMap。 OpenStreetMap（OSM）介绍： 一个开放的、免费的、全球性的地图项目，由全球的志愿者和地图爱好者们共同创建和维护。 OSM的数据包括道路、建筑、公园、河流、湖泊等各类地理信息。由于是由众多志愿者共同编辑，OSM的数据具有很高的实时性和详细程度，特别是在一些活跃的区域，地图数据的更新速度和精度往往超过商业地图服务。 用户可以直接在OSM官网下载地图数据，数据格式主要有OSM XML和PBF等。此外，还有一些第三方网站和工具提供更加便捷的数据下载和处理服务，如Geofabrik、Overpass API等。 OSM的数据可以在各种GIS软件中使用，如QGIS、ArcGIS等。此外，还可以使用Python的OSMnx、GeoPandas等库进行编程处理，或者通过Leaflet、Mapbox等JavaScript库将OSM数据集成到web地图应用中。 OSM的所有数据都在开放许可下发布，允许用户自由使用、修改和分发。这使得OSM成为了许多公共项目、研究机构和商业公司的重要数据来源。

  • 部门绩效考核评分表.xlsx

    部门绩效考核评分表

  • 12-11-运输车队长绩效考核表（含自动计算、等级评价）.xlsx

    12-11-运输车队长绩效考核表（含自动计算、等级评价）

  • ant-javadoc-1.9.4-2.el7.x64-86.rpm.tar.gz

    1、文件内容：ant-javadoc-1.9.4-2.el7.rpm以及相关依赖 2、文件形式：tar.gz压缩包 3、安装指令： #Step1、解压 tar -zxvf /mnt/data/output/ant-javadoc-1.9.4-2.el7.tar.gz #Step2、进入解压后的目录，执行安装 sudo rpm -ivh *.rpm 4、安装指导：私信博主，全程指导安装

  • springboot整合 freemarker方法

    springboot整合 freemarker方法

  • apache-commons-codec-1.8-7.el7.x64-86.rpm.tar.gz

    1、文件内容：apache-commons-codec-1.8-7.el7.rpm以及相关依赖 2、文件形式：tar.gz压缩包 3、安装指令： #Step1、解压 tar -zxvf /mnt/data/output/apache-commons-codec-1.8-7.el7.tar.gz #Step2、进入解压后的目录，执行安装 sudo rpm -ivh *.rpm 4、安装指导：私信博主，全程指导安装

Global site tag (gtag.js) - Google Analytics