`
kevin-qingzhan
  • 浏览: 84836 次
  • 性别: Icon_minigender_1
  • 来自: 北京
文章分类
社区版块
存档分类
最新评论

写出漂亮代码的七种方法

阅读更多
写出漂亮代码的七种方法

首先我想说明我本文阐述的是纯粹从美学的角度来写出代码,而非技术、逻辑等。以下为写出漂亮代码的七种方法:

1, 尽快结束 if语句

例如下面这个JavaScript语句,看起来就很恐怖:


Java代码
1 function findShape(flags, point, attribute, list) {   
  
2    if(!findShapePoints(flags, point, attribute)) {   
  
3        if(!doFindShapePoints(flags, point, attribute)) {   
  
4            if(!findInShape(flags, point, attribute)) {   
  
5                if(!findFromGuide(flags,point) {   
  
6                    if(list.count() > 0 && flags == 1) {   
  
7                          doSomething();   
  
8                    }   
  
9                }   
  
10            }   
  
11       }   
  
12    }      
  
13  } 
view plaincopy to clipboardprint?
1 function findShape(flags, point, attribute, list) {  
 
2    if(!findShapePoints(flags, point, attribute)) {  
 
3        if(!doFindShapePoints(flags, point, attribute)) {  
 
4            if(!findInShape(flags, point, attribute)) {  
 
5                if(!findFromGuide(flags,point) {  
 
6                    if(list.count() > 0 && flags == 1) {  
 
7                          doSomething();  
 
8                    }  
 
9                }  
 
10            }  
 
11       }  
 
12    }     
 
13  } 

1 function findShape(flags, point, attribute, list) {

2    if(!findShapePoints(flags, point, attribute)) {

3        if(!doFindShapePoints(flags, point, attribute)) {

4            if(!findInShape(flags, point, attribute)) {

5                if(!findFromGuide(flags,point) {

6                    if(list.count() > 0 && flags == 1) {

7                          doSomething();

8                    }

9                }

10            }

11       }

12    }  

13  }

但如果这么写就好看得多:
Java代码
1 function findShape(flags, point, attribute, list) {   
  
2    if(findShapePoints(flags, point, attribute)) {   
  
3        return;   
  
4    }   
  
5    
  
6    if(doFindShapePoints(flags, point, attribute)) {   
  
7        return;   
  
8    }   
  
9    
  
10    if(findInShape(flags, point, attribute)) {    
  
11        return;   
  
12    }   
  
13    
  
14    if(findFromGuide(flags,point) {   
  
15        return;   
  
16    }   
  
17    
  
18    if (!(list.count() > 0 && flags == 1)) {   
  
19        return;   
  
20    }   
  
21    
  
22    doSomething();   
  
23    
  
24 } 
view plaincopy to clipboardprint?
1 function findShape(flags, point, attribute, list) {  
 
2    if(findShapePoints(flags, point, attribute)) {  
 
3        return;  
 
4    }  
 
5   
 
6    if(doFindShapePoints(flags, point, attribute)) {  
 
7        return;  
 
8    }  
 
9   
 
10    if(findInShape(flags, point, attribute)) {   
 
11        return;  
 
12    }  
 
13   
 
14    if(findFromGuide(flags,point) {  
 
15        return;  
 
16    }  
 
17   
 
18    if (!(list.count() > 0 && flags == 1)) {  
 
19        return;  
 
20    }  
 
21   
 
22    doSomething();  
 
23   
 
24 } 

1 function findShape(flags, point, attribute, list) {

2    if(findShapePoints(flags, point, attribute)) {

3        return;

4    }

5

6    if(doFindShapePoints(flags, point, attribute)) {

7        return;

8    }

9

10    if(findInShape(flags, point, attribute)) {

11        return;

12    }

13

14    if(findFromGuide(flags,point) {

15        return;

16    }

17

18    if (!(list.count() > 0 && flags == 1)) {

19        return;

20    }

21

22    doSomething();

23

24 }


你可能会很不喜欢第二种的表述方式,但反映出了迅速返回if值的思想,也可以理解为:避免不必要的else陈述。



2, 如果只是简单的布尔运算(逻辑运算),不要使用if语句



例如:
Java代码
1 function isStringEmpty(str){   
  
2    if(str === "") {    
  
3        return true;   
  
4    }   
  
5    else {   
  
6        return false;   
  
7    }   
  
8 } 
view plaincopy to clipboardprint?
1 function isStringEmpty(str){  
 
2    if(str === "") {   
 
3        return true;  
 
4    }  
 
5    else {  
 
6        return false;  
 
7    }  
 
8 } 

1 function isStringEmpty(str){

2    if(str === "") {

3        return true;

4    }

5    else {

6        return false;

7    }

8 }

可以写为:
Java代码
1 function isStringEmpty(str){   
  
2    return (str === "");   
  
3 } 
view plaincopy to clipboardprint?
1 function isStringEmpty(str){  
 
2    return (str === "");  
 
3 } 

1 function isStringEmpty(str){

2    return (str === "");

3 }
3, 使用空白,这是免费的

例如:

1 Java代码
function getSomeAngle() {   
  
2    // Some code here then   
  
3    radAngle1 = Math.atan(slope(center, point1));   
  
4    radAngle2 = Math.atan(slope(center, point2));   
  
5    firstAngle = getStartAngle(radAngle1, point1, center);   
  
6    secondAngle = getStartAngle(radAngle2, point2, center);   
  
7    radAngle1 = degreesToRadians(firstAngle);   
  
8    radAngle2 = degreesToRadians(secondAngle);   
  
9    baseRadius = distance(point, center);   
  
10    radius = baseRadius + (lines * y);   
  
11    p1["x"] = roundValue(radius * Math.cos(radAngle1) + center["x"]);   
  
12    p1["y"] = roundValue(radius * Math.sin(radAngle1) + center["y"]);   
  
13    pt2["x"] = roundValue(radius * Math.cos(radAngle2) + center["y"]);   
  
14    pt2["y"] = roundValue(radius * Math.sin(radAngle2) + center["y");   
  
15    // Now some more code   
  
16 } 
view plaincopy to clipboardprint?
function getSomeAngle() {  
 
2    // Some code here then  
 
3    radAngle1 = Math.atan(slope(center, point1));  
 
4    radAngle2 = Math.atan(slope(center, point2));  
 
5    firstAngle = getStartAngle(radAngle1, point1, center);  
 
6    secondAngle = getStartAngle(radAngle2, point2, center);  
 
7    radAngle1 = degreesToRadians(firstAngle);  
 
8    radAngle2 = degreesToRadians(secondAngle);  
 
9    baseRadius = distance(point, center);  
 
10    radius = baseRadius + (lines * y);  
 
11    p1["x"] = roundValue(radius * Math.cos(radAngle1) + center["x"]);  
 
12    p1["y"] = roundValue(radius * Math.sin(radAngle1) + center["y"]);  
 
13    pt2["x"] = roundValue(radius * Math.cos(radAngle2) + center["y"]);  
 
14    pt2["y"] = roundValue(radius * Math.sin(radAngle2) + center["y");  
 
15    // Now some more code  
 
16 } 

function getSomeAngle() {

2    // Some code here then

3    radAngle1 = Math.atan(slope(center, point1));

4    radAngle2 = Math.atan(slope(center, point2));

5    firstAngle = getStartAngle(radAngle1, point1, center);

6    secondAngle = getStartAngle(radAngle2, point2, center);

7    radAngle1 = degreesToRadians(firstAngle);

8    radAngle2 = degreesToRadians(secondAngle);

9    baseRadius = distance(point, center);

10    radius = baseRadius + (lines * y);

11    p1["x"] = roundValue(radius * Math.cos(radAngle1) + center["x"]);

12    p1["y"] = roundValue(radius * Math.sin(radAngle1) + center["y"]);

13    pt2["x"] = roundValue(radius * Math.cos(radAngle2) + center["y"]);

14    pt2["y"] = roundValue(radius * Math.sin(radAngle2) + center["y");

15    // Now some more code

16 }

很多开发者不愿意使用空白,就好像这要收费一样。我在此并非刻意地添加空白,粗鲁地打断代码的连贯性。在实际编写代码的过程中,会很容易地发现在什么地方加入空白,这不但美观而且让读者易懂,如下:

Java代码
1 function getSomeAngle() {   
  
2    // Some code here then   
  
3    radAngle1 = Math.atan(slope(center, point1));   
  
4    radAngle2 = Math.atan(slope(center, point2));   
  
5    
  
6    firstAngle = getStartAngle(radAngle1, point1, center);   
  
7    secondAngle = getStartAngle(radAngle2, point2, center);   
  
8    
  
9    radAngle1 = degreesToRadians(firstAngle);   
  
10    radAngle2 = degreesToRadians(secondAngle);   
  
11    
  
12    baseRadius = distance(point, center);   
  
13    radius = baseRadius + (lines * y);   
  
14    
  
15    p1["x"] = roundValue(radius * Math.cos(radAngle1) + center["x"]);   
  
16    p1["y"] = roundValue(radius * Math.sin(radAngle1) + center["y"]);   
  
17    
  
18    pt2["x"] = roundValue(radius * Math.cos(radAngle2) + center["y"]);   
  
19    pt2["y"] = roundValue(radius * Math.sin(radAngle2) + center["y");   
  
20    // Now some more code   
  
21 }   
  
  
  
4, 不要使用无谓的注释   
  
无谓的注释让人费神,这实在很讨厌。不要标出很明显的注释。在以下的例子中,每个人都知道代码表达的是“students id”,因而没必要标出。   
  
1 function existsStudent(id, list) {   
  
2    for(i = 0; i < list.length; i++) {   
  
3       student = list[i];   
  
4    
  
5       // Get the student's id   
  
6       thisId = student.getId();   
  
7    
  
8       if(thisId === id) {   
  
9           return true;   
  
10       }   
  
11    }   
  
12    return false;      
  
13 } 
view plaincopy to clipboardprint?
1 function getSomeAngle() {  
 
2    // Some code here then  
 
3    radAngle1 = Math.atan(slope(center, point1));  
 
4    radAngle2 = Math.atan(slope(center, point2));  
 
5   
 
6    firstAngle = getStartAngle(radAngle1, point1, center);  
 
7    secondAngle = getStartAngle(radAngle2, point2, center);  
 
8   
 
9    radAngle1 = degreesToRadians(firstAngle);  
 
10    radAngle2 = degreesToRadians(secondAngle);  
 
11   
 
12    baseRadius = distance(point, center);  
 
13    radius = baseRadius + (lines * y);  
 
14   
 
15    p1["x"] = roundValue(radius * Math.cos(radAngle1) + center["x"]);  
 
16    p1["y"] = roundValue(radius * Math.sin(radAngle1) + center["y"]);  
 
17   
 
18    pt2["x"] = roundValue(radius * Math.cos(radAngle2) + center["y"]);  
 
19    pt2["y"] = roundValue(radius * Math.sin(radAngle2) + center["y");  
 
20    // Now some more code  
 
21 }  
 
 
 
4, 不要使用无谓的注释  
 
无谓的注释让人费神,这实在很讨厌。不要标出很明显的注释。在以下的例子中,每个人都知道代码表达的是“students id”,因而没必要标出。  
 
1 function existsStudent(id, list) {  
 
2    for(i = 0; i < list.length; i++) {  
 
3       student = list[i];  
 
4   
 
5       // Get the student's id  
 
6       thisId = student.getId();  
 
7   
 
8       if(thisId === id) {  
 
9           return true;  
 
10       }  
 
11    }  
 
12    return false;     
 
13 } 

1 function getSomeAngle() {

2    // Some code here then

3    radAngle1 = Math.atan(slope(center, point1));

4    radAngle2 = Math.atan(slope(center, point2));

5

6    firstAngle = getStartAngle(radAngle1, point1, center);

7    secondAngle = getStartAngle(radAngle2, point2, center);

8

9    radAngle1 = degreesToRadians(firstAngle);

10    radAngle2 = degreesToRadians(secondAngle);

11

12    baseRadius = distance(point, center);

13    radius = baseRadius + (lines * y);

14

15    p1["x"] = roundValue(radius * Math.cos(radAngle1) + center["x"]);

16    p1["y"] = roundValue(radius * Math.sin(radAngle1) + center["y"]);

17

18    pt2["x"] = roundValue(radius * Math.cos(radAngle2) + center["y"]);

19    pt2["y"] = roundValue(radius * Math.sin(radAngle2) + center["y");

20    // Now some more code

21 }



4, 不要使用无谓的注释

无谓的注释让人费神,这实在很讨厌。不要标出很明显的注释。在以下的例子中,每个人都知道代码表达的是“students id”,因而没必要标出。

1 function existsStudent(id, list) {

2    for(i = 0; i < list.length; i++) {

3       student = list[i];

4

5       // Get the student's id

6       thisId = student.getId();

7

8       if(thisId === id) {

9           return true;

10       }

11    }

12    return false;  

13 }


5, 不要在源文件中留下已经删除的代码,哪怕你标注了

如果你使用了版本控制,那么你就可以轻松地找回前一个版本的代码。如果别人大费周折地读了你的代码,却发现是要删除的代码,这实在太恨人了。


Java代码
//function thisReallyHandyFunction() {   
  
//      someMagic();   
  
//      someMoreMagic();   
  
//      magicNumber = evenMoreMagic();   
  
//      return magicNumber;   
  
//} 
view plaincopy to clipboardprint?
//function thisReallyHandyFunction() {  
 
//      someMagic();  
 
//      someMoreMagic();  
 
//      magicNumber = evenMoreMagic();  
 
//      return magicNumber;  
 
//} 

//function thisReallyHandyFunction() {

//      someMagic();

//      someMoreMagic();

//      magicNumber = evenMoreMagic();

//      return magicNumber;

//}

6,不要有太长的代码



看太长的代码实在太费劲,尤其是代码本身的功能又很小。如下:


Java代码
1 public static EnumMap<Category, IntPair> getGroupCategoryDistribution(EnumMap<Category, Integer> sizes, int groups) {   
  
2        EnumMap<Category, IntPair> categoryGroupCounts = new EnumMap<Category,IntPair>(Category.class);   
  
3    
  
4        for(Category cat : Category.values()) {   
  
5            categoryGroupCounts.put(cat, getCategoryDistribution(sizes.get(cat), groups));   
  
6        } 
view plaincopy to clipboardprint?
1 public static EnumMap<Category, IntPair> getGroupCategoryDistribution(EnumMap<Category, Integer> sizes, int groups) {  
 
2        EnumMap<Category, IntPair> categoryGroupCounts = new EnumMap<Category,IntPair>(Category.class);  
 
3   
 
4        for(Category cat : Category.values()) {  
 
5            categoryGroupCounts.put(cat, getCategoryDistribution(sizes.get(cat), groups));  
 
6        } 

1 public static EnumMap<Category, IntPair> getGroupCategoryDistribution(EnumMap<Category, Integer> sizes, int groups) {

2        EnumMap<Category, IntPair> categoryGroupCounts = new EnumMap<Category,IntPair>(Category.class);

3

4        for(Category cat : Category.values()) {

5            categoryGroupCounts.put(cat, getCategoryDistribution(sizes.get(cat), groups));

6        }

#



我并不是说非要坚持70个字符以内,但是一个比较理想的长度是控制在120个字符内。如果你把代码发布在互联网上,用户读起来就很困难。

7,不要在一个功能(或者函数内)有太多代码行

我的一个老同事曾经说Visual C++很臭,因为它不允许你在一个函数内拥有超过10,000行代码。我记不清代码行数的上限,不知道他说的是否正确,但我很不赞成他的观点。如果一个函数超过了50行,看起来有多费劲你知道么,还有没完没了的if循环,而且你还的滚动鼠标前后对照这段代码。对我而言,超过35行的代码理解起来就很困难了。我的建议是超过这个数字就把一个函数代码分割成两个
分享到:
评论

相关推荐

    跨年烟花代码代码写出漂亮的动态烟花

    跨年烟花代码代码写出漂亮的动态烟花

    如何写出漂亮的代码:改良程序的11个技巧

    如何写出漂亮的代码:改良程序的11个技巧!有很多理由都能说明为什么我们应该写出清晰、可读性好的程序。最重要的一点,程序你只写一次,但以后会无数次的阅读。当你第二天回头来看你的代码时,你就要开始阅读它了。...

    如何写出漂亮的代码

    所以我们写代码要漂亮、要优雅。  这种代码维护成本相当高,要改一个bug或者新增加一个极小的功能,都可以把人玩死。首先是一个方法上来三四百行,硬看是看不懂的,为什么?举这么几个例子:  1. 没有意义的...

    C#写的漂亮的抽奖源代码

    总之,这个“C#写的漂亮的抽奖源代码”涵盖了C#语言基础、面向对象编程、随机数生成、UI设计以及事件驱动编程等多个知识点。通过分析和学习这样的源代码,开发者不仅可以提升C#技能,还能了解到如何结合业务需求,...

    译文:如何写出漂亮的HTML代码

    What Beautiful HTML Code Looks Like 如何写出漂亮的HTML代码. 老外写的一篇文章:What Beautiful HTML Code Looks Like 如何写出漂亮的HTML代码 感觉写的非常的不错,转载过来,与大家分享一下:ps:原文地址:...

    C#写的漂亮的抽奖源代码2019

    在这个项目中,"C#写的漂亮的抽奖源代码2019"揭示了如何利用C#构建一个具有视觉吸引力且功能完善的抽奖系统。这个系统的实现不仅涉及基本的编程技术,还涵盖了图形用户界面(GUI)设计、随机数生成、事件处理等关键...

    C# windowns漂亮的窗口界面代码

    对于自定义控件,如按钮,你可以使用`Pen`和`FillRectangle`方法来画出边框和填充色,`DrawString`来绘制文字。例如: ```csharp Rectangle buttonRect = new Rectangle(10, 10, 100, 30); // 按钮位置和大小 ...

    C#写的漂亮的抽奖源代码.rar

    在本资源"C#写的漂亮的抽奖源代码.rar"中,我们可以深入探讨C#编程语言在实现一个美观且功能完善的抽奖系统中的应用。C#是Microsoft公司推出的一种面向对象的编程语言,广泛应用于Windows平台上的应用程序开发,包括...

    非常漂亮的页面导航代码,纯CSS+JQUERY

    "非常漂亮的页面导航代码,纯CSS+JQUERY"这个主题聚焦于如何利用这两门技术来创建美观且功能强大的导航菜单。CSS(层叠样式表)负责样式设计,而JQUERY则用于增强交互性。 首先,让我们深入了解CSS。CSS是一种标记...

    程序设计修养,对于想把C代码写的漂亮和可读性更高的人而言很不错

    这不仅仅是关于技术细节或底层编程技巧的问题,更是一种态度、一种对代码艺术的追求。 #### 二、什么是好的程序员? 文件提到,一个好的程序员不仅要有扎实的技术基础,还需要具备良好的编程修养。这里列出了几个...

    用lable写出漂亮的表格

    "用lable写出漂亮的表格"这个主题聚焦于如何利用编程语言中的lable(可能是标签或者拼写错误,通常应为`label`)库来构建高效且视觉效果良好的表格。在Python中,Pandas库的`DataFrame`对象可以与matplotlib的`...

    书写漂亮的代码(author:Laura Thomson)-推荐

    - **历史演变**:作者最初关注的是错误的代码编写方式,后来转向积极的一面,即如何写出优秀、高效的代码。 - **作者简介**:Laura Thomson是一位资深的PHP开发者,拥有丰富的工程经验和咨询背景。她曾在Mozilla等...

    C#写的漂亮的抽奖源代码(0520_).rar

    在这个名为"C#写的漂亮的抽奖源代码(0520_).rar"的压缩包中,我们拥有一份使用C#编写的精美抽奖程序的源代码。这份源代码对于学习C#编程,尤其是涉及到图形用户界面(GUI)设计、随机数生成以及事件处理等概念的...

    写出漂亮代码:改良程序的11个技巧

    写出漂亮代码是每个程序员都应该追求的目标,因为它直接影响到代码的可读性、可维护性和团队协作效率。以下是一些改良程序的技巧: 1. **尽量保持方法简短**:一个方法应该只做一件事,且尽量控制在5-20行内,避免...

    C#写的漂亮的抽奖源代码-YQZ.rar

    在本资源"C#写的漂亮的抽奖源代码-YQZ.rar"中,我们主要关注的是使用C#编程语言实现的抽奖系统。C#是一种面向对象的、类型安全的编程语言,广泛应用于Windows应用程序、游戏开发以及Web服务等多个领域。在这个项目中...

Global site tag (gtag.js) - Google Analytics