做一个像qq空间的网站,网站建设录哪个科目,wordpress去掉作者,网站线框图用什么做原文出处#xff1a; goyello 译文出处#xff1a; 外刊IT评论 编程初学者总是把大量的时间用在学习编程语言#xff0c;语法#xff0c;技巧和编程工具的使用上。他们认为#xff0c;如果掌握了这些技术技巧#xff0c;他们就能成为不错的程序员。然而#xff0c;计算…原文出处 goyello 译文出处 外刊IT评论 编程初学者总是把大量的时间用在学习编程语言语法技巧和编程工具的使用上。他们认为如果掌握了这些技术技巧他们就能成为不错的程序员。然而计算机编程的目的并不是关于精通这些技术、工具的它是关于针对特定领域里的特定问题创造出相应的解决方案程序员通过相互合作来实现这些。所以很重要的一点你需要能精确的用代码表达出你的思想让其他人通过代码能明白你的意图。 让我们先看看编程大师Robert C. Martin的杰作《Clean Code | 代码整洁之道》里的一句话 “注释的目的是为了弥补代码自身在表达上的不足。” 这句话可以简单的理解为如果你的代码需要注释最有可能是你的代码写的很烂。同样如果在没有注释的情况下你无法用代码完整的表达你对一个问题或一个算法的思路那这就是一个失败的信号。最终这意味着你需要用注释来阐明一部分的思想而这部分在代码里是看不出来的。好的代码能够让任何人在不需要任何注释的情况下看懂。好的编码风格能将所有有助于理解这个问题的所有信息都蕴含在代码里。 在编程理论中有一个概念叫做“自我描述的源代码”。对于一段代码一种常见的自我描述机制是遵循某种非严格定义的变量、方法、对象命名规则。这样做的主要作用就是使源代码更易读易懂。所以也就更容易维护和扩展。 这篇文章里我将举出一些例子说明什么是“不好的代码”什么是“清楚的代码” 命名要能揭示意图 如何命名在编程中这永远都是个老大难问题。有些程序员喜欢简化、缩短或加密名称使得只有他们自己能懂。下面让我们看一些例子 不好的代码 1 2 3 4 5 int d; // 天数 int ds; int dsm; int faid; “d”可以表示任何东西。作者使用注释来表明他的意图却没有选择用代码来表示。而“faid”很容易导致误解为ID。 清楚的代码 1 2 3 4 int elapsedTimeInDays; int daysSinceCreation; int daysSinceModification; int fileAgeInDays; 命名时避免含义引起误解的信息 错误的信息比没有信息更糟糕。有些程序员喜欢“隐藏”一些重要信息有时候他们也会写出一些让人误解的代码。 不好的代码 1 2 Customer[] customerList; Table theTable; 变量“customerList”其实不是个list。它是一个普通的array(或客户集合)。除此之外“theTable”是一个Table类型的对象(你可以用IDE容易的发现它的类型)“the”这个词是个不必要的干扰。 清楚的代码 1 2 Customer[] customers; Table customers; 命名要有合适的长度 在高级编程语言中变量名的长度通常不太限制。变量名几乎可以任何长度。虽然如此这也可能使代码变得闹心。 不好的代码 1 2 var theCustomersListWithAllCustomersIncludedWithoutFilter; var list; 好的名称应该只含有必要的词汇来表达一个概念。任何不必要的字词都会使名称变长、难于理解。名称越短越好前提是能在上下文中表达完整的意思(下订单这个场景中“customersInOrder” 要比 “list” 好)。 清楚的代码 1 2 var allCustomers; var customersInOrder; 命名时编码规范保持一致让规范帮助理解代码 所有的编程技术(语言)都有自己的“风格”叫做编码规范。程序员应该在写代码时遵循这些习惯因为其他的程序员也知道这些并按这种风格编写。下面我们看一个没有明显规范的不好的代码例子。下面的这段代码没有遵循很好的已知的“编码规范”(比如PascalCase, camelCase, Hungarian规范)。更糟糕的是这有一个毫无意义的bool变量“change”。这是个动词(用来描述动作)但这里的bool值是来描述一个状态所以这里应该用一个形容词更合适。 不好的代码 1 2 3 4 5 6 const int maxcount 1 bool change true public interface Repository private string NAME public class personaddress void getallorders() 一段代码只看它的一部分你就应该直接明白它是什么类型只需要看它的命名方法。 例如你看到了“_name”你就能知道它是个私有变量。你应该在任何地方都利用这种表示方法没有例外情况。 清楚的代码 1 2 3 4 5 6 const int MAXCOUNT 1 bool isChanged true public interface IRepository private string _name public class PersonAddress void GetAllOrders() 命名时相同的概念用相同的词表达 定义概念很难。在软件开发过程中很多时间都花在分析业务场景、思考正确的定义里面所有的元素。这些概念永远都是让程序员头痛的事。 不好的代码 1 2 3 4 5 6 7 //1. void LoadSingleData() void FetchDataFiltered() Void GetAllData() //2. void SetDataToView(); void SetObjectValue(int value) 首先 代码的作者试图表达“get the data”的概念他使用了多个词“load”“getch”“get”。一个概念只用一个词表达就行了(在同一个场景中)。 第二 “set”这个词用在了2个概念里第一是“data loading to view”第二个是“setting a value of object”。这是两个不同的概念你应该使用不同的词。 清楚的代码 1 2 3 4 5 6 7 //1. void GetSingleData() void GetDataFiltered() Void GetAllData() //2. void LoadDataToView(); void SetObjectValue(int value) 命名时使用跟业务领域相关的词 程序员写的所有代码都是跟业务领域场景逻辑相连的。为了让所有关系到这个问题的人都能更好的理解程序中应该使用在领域环境中有意义的名称。 不好的代码 1 2 3 4 5 public class EntitiesRelation { Entity o1; Entity o2; } 当在编写针对某个领域的代码时你应该始终考虑使用领域有联系的名称。在将来当另外一个人(不仅是程序员也许是测试人员)接触你的代码时他能轻松的理解这个业务领域里你的代码是什么意思(不需要业务逻辑知识)。你首先考虑的应该是业务问题之后才是如何解决。 清楚的代码 1 2 3 4 5 public class ProductWithCategory { Entity product; Entity category; } 命名时使用在特定环境里有意义的词 代码里名称都有自己的上下文。上下文对于理解一个名称非常重要因为它能提供额外的信息。让我们来看看一个典型的“地址”上下文 不好的代码 1 2 3 string addressCity; string addressHomeNumber; string addressPostCode; 在大多数情况中“Post Code”通常是地址的一部分很显然邮政编码不能单独使用(除非你是在开发一个专门处理邮编的应用)。所以没有必要在“PostCode”的前面加上“address”。更重要的所以的这些信息都有一个上下文容环境一个命名空间一个类。 在面向对象编程中这里应该用一个“Address”类来表达这个地址信息。 清楚的代码 1 2 3 4 5 6 class Address { string city; string homeNumber; string postCode; } 命名方法总结 概述起来做为一个程序员你应该 命名是来表达概念的注意名称长度名称里只该含有必要的词语编码规范有助于理解代码你应该使用它名称不要混用名称在业务领域里要有意义在上下文里有意义转载于:https://www.cnblogs.com/daocaowu/archive/2013/06/07/3125452.html
