编程风格——整洁代码的4个提示

整洁代码的4个提示

虽然这样的文章非常的多,并且,就算是对于编程新手来说,也是非常的简单和显而见,但是,在我们进行Code Review过程中,我们还是能够看到那些非常混乱的代码,所以,有些时候,你会在想,是不是这样的规则太多了,导致我们的程序员记不住。虽然我们在以前的文章中一遍又一遍的说过(比如:《优质代码的十诫》),千言万语总结一下,无论你用什么样的语言,最最基本的编程原则就是下面这四条。

1 – 简短的方法
简单才会易读,简单才会容易,简单才能重用,简单才能保证质量。把一件事搞复杂,是一件简单的事;而把一件事变简单,这则是一件复杂的事。KISS-Keep it Simple Stupid是一种哲学,Do one thing, Do it best也是一种哲学。这些都是在告诉我们,做设计,做产品,不要把所有的东西一下子都考虑进来,否则将会让你的事情变成一团糟,剪不断理还乱,就是这样道理。把复杂的事情,困难的事情,逐步细化,分解成一个一个简单而单一的事情,然后再把他们拼装起来完成一个复杂的事情,是我们如何完成一个巨大并复杂的项目的通用方法。
编程也是这个道理,维护代码的成本会比你创造代码的成本要大得多,所以,一个简短的方法不但可以有利于阅读,维护,重用,同样在进行排错调试测试的时候也能起到巨大的帮助。比如,对于一个简单的方法或函数,单元测试,功能测试,性能测试、代码覆盖,质量保证都能变得相当简单,而这些众多的质量优良的方法最终组成了那质量过硬的最终产品,并让我们在以后的代码不断改进中继续充当重要的作用。

2 – 选择望文知意的直观的变量名和函数名
无论是变量名还是方法名,都不能太长或是太短。一个好的命名,应该是“自解释的”,直观的,望文知意的。通常来说,一个好的命名应该是知道这个变量/方法要干什么事情,比如GetComputerName(),isAdmin等等,对于变量名来说,通过其名字,我们可以知道这个变量的类型(整型,浮点,指针,……),种类(全局,成员,局部,静态,……)。关于命名的事情,可以查看《编程命名中的7+1个提示》和《编程中的命名设计那点事》查看更多的内容。

3 – 只写有意义的注释
代码写得好的话,是不需要注释的。与其花费大量的时候去写注释,还不如把这些时间花在代码重构上,简洁/易读的代码比详细的注释更有意义。另外,如果你需要使用你的注释来生成文档,那么也不需要太过复杂,这通常用来做API的文档,这个时候,关键不在于你是如何实现的,而是在于告诉别人完成什么样的事并如何使用之。总之,一句话,如果你的代码足够的简单和清楚,你是不需要写注释的。

4 – 让你的代码可读
你的代码并不只是让编译器去阅读的,你的代码更应该是让你的同事和其它人阅读的。所以,一定要遵守团队内部的那些最中规中矩的编程规范或代码风格,千万不要在代码中使你的小聪明或是偷懒或是hack代码,那样做的结果只会有两个,一个是你的代码会被后人骂得一无是处,另一个就是当你在以后维护你的代码时无异于搬起石头砸了自己的脚。编码坚持最基本的两个原则—— KISS 和DRY,剩下的就是顺从于自然。
(全文完)

时间: 2025-01-31 14:52:35

编程风格——整洁代码的4个提示的相关文章

强调一下编程风格

讲完了Java的基础语法,大家就可以编写简单的程序代码了,这里有必要强调一下编程风格. 代码风格虽然不影响程序的运行,但对程序的可读性却非常重要.自己编写的程序要让别人看懂,首先在排版方面要非常注意. 其实每个人的编程风格.每个软件开发公司的编程风格都不一样.一个人编写的程序代码,就应该能让别人看懂,甚至是过了很长时间,自己也要看的懂,否则这个程序就成了一个死程序. 编程风格是指编程时的格式,让程序看上去就很有层次感.下面通过一些例子,说明编程风格的重要性: public class math{

Java知多少(17)强调一下编程风格

讲完了Java的基础语法,大家就可以编写简单的程序代码了,这里有必要强调一下编程风格. 代码风格虽然不影响程序的运行,但对程序的可读性却非常重要.自己编写的程序要让别人看懂,首先在排版方面要非常注意. 其实每个人的编程风格.每个软件开发公司的编程风格都不一样.一个人编写的程序代码,就应该能让别人看懂,甚至是过了很长时间,自己也要看的懂,否则这个程序就成了一个死程序. 编程风格是指编程时的格式,让程序看上去就很有层次感.下面通过一些例子,说明编程风格的重要性: 1 public class mat

Java学习——强调一下编程风格

讲完了Java的基础语法,大家就可以编写简单的程序代码了,这里有必要强调一下编程风格. 代码风格虽然不影响程序的运行,但对程序的可读性却非常重要.自己编写的程序要让别人看懂,首先在排版方面要非常注意.其实每个人的编程风格.每个软件开发公司的编程风格都不一样.一个人编写的程序代码,就应该能让别人看懂,甚至是过了很长时间,自己也要看的懂,否则这个程序就成了一个死程序.编程风格是指编程时的格式,让程序看上去就很有层次感.下面通过一些例子,说明编程风格的重要性: 上面程序段的整个排版看起来是否很舒服,并

【C++系列小结】面向过程的编程风格

前言 编程语言有面向过程和面向对象之分,因此编程风格也有所谓的面向过程的编程和面向对象的编程,而且语言的性质不会限制编程的风格. 这里主要说一下面向过程的编程. "面向过程"(Procedure Oriented)是一种以过程为中心的编程思想. C语言是面向过程的编程语言,但是依然可以写出面向对象的程序,同样C++也当然可以写出面向过程的程序咯. 如果我们把所有的程序代码都写在一个main函数里面,那么这个程序显然会显得很不和谐吧.理想一点的做法是我们把一些看起来和main函数逻辑上关

Google Java编程风格指南(转)

目录 前言 源文件基础 源文件结构 格式 命名约定 编程实践 Javadoc 后记 前言 这份文档是Google Java编程风格规范的完整定义.当且仅当一个Java源文件符合此文档中的规则, 我们才认为它符合Google的Java编程风格. 与其它的编程风格指南一样,这里所讨论的不仅仅是编码格式美不美观的问题, 同时也讨论一些约定及编码标准.然而,这份文档主要侧重于我们所普遍遵循的规则, 对于那些不是明确强制要求的,我们尽量避免提供意见. 1.1 术语说明 在本文档中,除非另有说明: 术语cl

Google Java编程风格指南

作者:Hawstein出处:http://hawstein.com/posts/google-java-style.html声明:本文采用以下协议进行授权: 自由转载-非商用-非衍生-保持署名|Creative Commons BY-NC-ND 3.0 ,转载请注明作者及出处. 目录 前言 源文件基础 源文件结构 格式 命名约定 编程实践 Javadoc 后记 前言 这份文档是Google Java编程风格规范的完整定义.当且仅当一个Java源文件符合此文档中的规则, 我们才认为它符合Googl

[转]Google的Java编程风格指南(Java编码规范)

这份文档是Google Java编程风格规范的完整定义.当且仅当一个Java源文件符合此文档中的规则, 我们才认为它符合Google的Java编程风格. 与其它的编程风格指南一样,这里所讨论的不仅仅是编码格式美不美观的问题, 同时也讨论一些约定及编码标准.然而,这份文档主要侧重于我们所普遍遵循的规则, 对于那些不是明确强制要求的,我们尽量避免提供意见. 1.1 术语说明 在本文档中,除非另有说明: 1.术语class可表示一个普通类,枚举类,接口或是annotation类型(@interface

C++新手之培养良好的编程风格

内功深厚的武林高手出招往往平淡无奇.同理,编程高手也不会用奇门怪招写程序.良好的编程风格是产生高质量程序的前提. 下面以C++为例,来给大家介绍. 一. 命名约定 有不少人编程时用拼音给函数或变量命名,这样做并不能说明你很爱国,却会让用此程序的人迷糊(很多南方人不懂拼音,我就不懂).程序中的英文一般不会太复杂,用词要力求准确.匈牙利命名法是Microsoft 公司倡导的[Maguire 1993],虽然很烦琐,但用习惯了也就成了自然.没有人强迫你采用何种命名法,但有一点应该做到:自己的程序命名必

MATLAB 编程风格指南及注意事项

MATLAB编程风格指南Richard Johnson 著Genial 译MATLAB 编程风格指南Richard JohnsonVersion 1.5,Oct. 2002版权: Datatool 所有翻译:Genial @ USTC“Language is like a cracked kettle on which we beat tuned to dance to, while allthe time we long to move the stars to pity.”- Gustave