《从零開始学Swift》学习笔记(Day 59)——代码排版

原创文章,欢迎转载。转载请注明:关东升的博客 

代码排版包括: 空行、空格、断行和缩进等内容。代码排版内容比較多工作量非常多。可是非常重要。


空行

空行将逻辑相关的代码段分隔开。以提高可读性。

下列情况应该总是加入空行:

  • 类型声明之前。

  • import语句前后。

  • 两个方法或函数之间。

  • 块凝视或单行凝视之前。

  • 方法或函数内的两个逻辑段之间,用以提高可读性。

  • 一个源文件的两个片段之间。

空格

在代码中有些位置是须要有空格的,这个工作量也是非常大的。下列是使用空格的规范:

1.赋值符号“=”前后有一个空格。varlet与标识符之间有一个空格。全部的二元运算符。应该使用空格将之与操作数分开。一元操作符和操作数之间不因该加空格。如:++--等。示比例如以下。

var a = 10
var c = 10
a += c + d


2. 小左括号“(”之后。小右括号“)”之前不要有空格。示比例如以下。

a = (a + b) / (c * d)

3. 大左括号“{”之前有一个空格。示比例如以下。

while a == d {

    n++

}

4. 在方法或函数參数之前间有一个空格,參数冒号与数据类型之间有一个空格。

推荐使用:

func tableView(tableView: UITableView, didSelectRowAtIndexPath indexPath: NSIndexPath) {

    ...

}

不推荐使用:

func tableView ( tableView: UITableView, didSelectRowAtIndexPath indexPath: NSIndexPath ) {

    ...

}

断行

一行代码的长度尽量避免超过80个字符。为了便于查看是否一行代码超出80个字符。非常多IDE开发工具都能够在编辑窗体设置显示80行竖线。在Xcode中设置过程是打开菜单Xcode→Preferences。选择Text Editing标签,选中Show→Page guideat column

因为有的代码比較长须要断行,能够根据例如以下一般规范断开:

  • 在一个逗号后面断开。

  • 在一个操作符前面断开,要选择较高级别运算符断开,而非较低级别运算符断开。

  • 新的一行应该与上一行缩进两个级别(8个空格)

缩进

4个空格常被作为缩进排版的一个单位,在开发时候使用制表符进行缩进,尽管默认情况下一个制表符等于8个空格。可是在不同的IDE工具中可能设置的一个制表符与空格相应个数会有所不同。在Xcode中默认是一个制表符相应4个空格。我们能够在Xcode中打开菜单Xcode→Preferences,选择Text Editing→Indentation标签,能够在Tab width中进行设置。

缩进能够根据例如以下一般规范:

  • 在函数、方法、闭包、控制语句、计算属性等包括大括号“{}”代码块中。代码块中的内容与首行缩进一个级(4个空格)。

  • 假设是if语句中条件表达式的断行。那么新的一行应该与上一行缩进两个级别(8个空格),再往后的断行要与第一次的断行对齐。


欢迎关注关东升新浪微博@tony_关东升。


关注智捷课堂微信公共平台,了解最新技术文章、图书、教程信息
 

很多其它精品iOSCocos、移动设计课程请关注智捷课堂官方站点:http://www.zhijieketang.com
智捷课堂论坛站点:http://51work6.com/forum.php


 


原文地址:https://www.cnblogs.com/jzssuanfa/p/6986410.html