Swift编写规范
2016-07-14 15:22
393 查看
学习自:
http://www.csdn.net/article/2015-08-20/2825503-swift-style-guide/1
命名(同OC)
使用驼峰式的描述性命名方式,为类,方法,变量等命名。类名的首字母应该大写,而方法和变量的首字母使用小写字符。
推荐做法:
对于函数和初始化方法,推荐对所有的参数进行有意义的命名,除非上下文已经非常清楚。如果外部参数命名可以使得函数调用更加可读,也应该把外部参数命名包含在内。
对于方法来说,参照标准的苹果惯例,方法命名含义要引用到第一个参数:
枚举
使用首字母大写的驼峰命名规则来命名枚举值:
文章
类的前缀
Swift类型自动被模块名设置了名称空间,所以你不需要加一个类的前缀。如果两个来自不同模块的命名冲突了,你可以附加一个模块名到类型命名的前面来消除冲突。
函数声明
保证短的函数定义在同一行中,并且包含左大括号:
在一个长的函数定义时,在适当的地方进行换行,同时在下一行中添加一个额外的缩进:
闭包表达式
如果闭包表达式参数在参数列表中的最后一个时,使用尾部闭包表达式。给定闭包参数一个描述性的命名。
不推荐做法:
当单个闭包表达式上下文清晰时,使用隐式返回值:
类型
尽可能使用 Swift 原生类型。Swift 提供到 Objective-C 类型的桥接,所以你仍然可以使用许多需要的方法。
不推荐做法:
常亮
常量定义使用 let 关键字,变量定义使用 var 关键字,如果变量的值不需要改变,请尽量使用 let 关键字。
提示:一个好的技巧是,使用 let 定义任何东西,只有在编译器告诉我们值需要改变的时候才改成 var 定义。
可选类型
当nil值是可以接受的时候时,定义变量和函数返回值为可选类型(?)。
当你确认变量在使用前已经被初始化时,使用!来显式的拆包类型,比如在viewDidLoad中会初始化subviews。
当你访问一个可选值时,如果只需要访问一次或者在可选值链中有多个可选值时,请使用可选值链:
当需要很方便的一次性拆包或者添加附加的操作时,请使用可选值绑定:
当我们命名一个可选变量和属性时,避免使用诸如optionalString和maybeView这样的命名,因为可选值的表达已经在类型定义中了。
在可选值绑定中,直接映射原始的命名比使用诸如unwrappedView和actualLabel要好。
推荐做法
不推荐做法:
结构体构造器
使用原生的 Swift 结构体构造器,比老式的几何类(CGGeometry)的构造器要好。
推荐做法
不推荐做法
推荐使用结构体限定的常量CGRect.infiniteRect,CGRect.nullRect等,来替代全局常量CGRectInfinite,CGRectNull等。对于已经存在的变量,可以直接简写成 .zeroRect
类型推断
推荐使用更加紧凑的代码,让编译器能够推断出常量和变量的类型。除非你需要定义一个特定的类型(比如CGFloat和Int16),而不是默认的类型。
推荐做法
不推荐做法
注意:遵守这条规则意味选择描述性命名比之前变得更加重要。
语法糖
推荐使用类型定义简洁的版本,而不是全称通用语法。
推荐做法:
不推荐做法:
控制流
推荐循环使用for-in表达式,而不使用for-condition-increment表达式。
推荐做法:
不推荐做法
分号
Swift不需要在你代码中的每一句表达式之后添加分号。只有在你需要在一行中连接多个表达式中,使用分号来区隔。
不要在同一行编写多个使用分号区隔的表达式。
唯一的例外是在使用for-conditional-increment 架构。然而,尽可能使用for-in架构来替代它。
推荐做法:
不推荐做法
语言
推荐做法
不推荐做法
版权声明
放在被包含的所在源文件顶部
注释
当你需要时,使用注释来解释一段特定的代码段的作用。注释必须保证更新或者及时删除。
避免在代码中使用块注释,代码尽可能自己能表达含义。以下情况除外:当使用注释来生成文档时。
类和结构体
选择使用谁?
请记住,结构体是值类型。使用结构体并没有一个标识。一个数组包含[a, b, c]和另外一个数组同样包含[a, b, c]是完全一样的,它们完全可以交换使用。使用第一个还是使用第二个无关紧要,因为它们代表的是同一个东西。这就是为什么数组是结构体。
类是引用类型。使用类是有一个标识或者有一个特定的生命周期。你需要对一个人类建模为一个类,因为两个不同的人的实例,是两个不同的东西。只是因为两个人有同样的名字和生日,也不能断定这两个人是一样的。但是人的生日是一个结构体,因为日期1950-3-3和另外一个日期1950-3-3是相同的。日期不需要一个标识。
有时,一些事物应该定义为结构体,但是需要兼容AnyObject或者已经在以前的历史版本中定义为类(NSDate,NSSet)。尽可能的尝试遵守这些规则。
定义的案例
以上例子遵循了以下风格规范:
指定属性、变量、常量、参数定义或者其他定义的类型,在冒号后面,紧跟着一个空格,而不是把空格放在冒号前面。比如:x: Int和Circle: Shape。
如果能表示相同的目的和上下文,可以在同一行定义多个变量和结构体。
缩进getter,setter的定义和属性观察器的定义。
不需要添加internal这样的默认的修饰符。同样的,不需要在重写一个方法时添加访问修饰符。
self的使用
为了保持简洁,避免使用 self 关键词,Swift 不需要使用 self 来访问对象属性和调用对象方法。
必须使用 self 来区分构造器中属性命名和参数命名,还有在闭包表达式中引用属性值(编译器需要区分):
协议遵守
当我们对一个类添加协议时,推荐使用一个单独的类扩展来实现协议的方法。这可以保持协议相关的方法聚合在一起,同时也可以简单的标识出一个协议对应类中需要实现哪些对应的方法。
同时,别忘了添加// MARK:,注释可以使得代码组织的更好!
推荐做法:(要区别OC)
不推荐做法
计算属性
为了保持简洁,如果一个计算属性是只读的,请忽略掉get语句。只有在需要定义set语句的时候,才提供get语句。
推荐做法
不推荐做法
http://www.csdn.net/article/2015-08-20/2825503-swift-style-guide/1
命名(同OC)
使用驼峰式的描述性命名方式,为类,方法,变量等命名。类名的首字母应该大写,而方法和变量的首字母使用小写字符。
推荐做法:
private let maximumWidgetCount = 100 class WidgetContainer { var widgetButton: UIButton let widgetHeightPercentage = 0.85 }
对于函数和初始化方法,推荐对所有的参数进行有意义的命名,除非上下文已经非常清楚。如果外部参数命名可以使得函数调用更加可读,也应该把外部参数命名包含在内。
func dateFromString(dateString: String) -> NSDate func convertPointAt(#column: Int, #row: Int) -> CGPoint func timedAction(#delay: NSTimeInterval, perform action: SKAction) -> SKAction! // 调用方式如下: dateFromString("2014-03-14") convertPointAt(column: 42, row: 13) timedAction(delay: 1.0, perform: someOtherAction)
对于方法来说,参照标准的苹果惯例,方法命名含义要引用到第一个参数:
class Guideline { func combineWithString(incoming: String, options: Dictionary?) { ... } func upvoteBy(amount: Int) { ... } }
枚举
使用首字母大写的驼峰命名规则来命名枚举值:
enum Shape { case Rectangle case Square case Triangle case Circle }
文章
类的前缀
Swift类型自动被模块名设置了名称空间,所以你不需要加一个类的前缀。如果两个来自不同模块的命名冲突了,你可以附加一个模块名到类型命名的前面来消除冲突。
import SomeModule let myClass = MyModule.UsefulClass()
函数声明
保证短的函数定义在同一行中,并且包含左大括号:
view plaincopy func reticulateSplines(spline: [Double]) -> Bool { // reticulate code goes here }
在一个长的函数定义时,在适当的地方进行换行,同时在下一行中添加一个额外的缩进:
view plaincopy func reticulateSplines(spline: [Double]) -> Bool { // reticulate code goes here }
闭包表达式
如果闭包表达式参数在参数列表中的最后一个时,使用尾部闭包表达式。给定闭包参数一个描述性的命名。
UIView.animateWithDuration(1.0) { self.myView.alpha = 0 } UIView.animateWithDuration(1.0, animations: { self.myView.alpha = 0 }, completion: { finished in self.myView.removeFromSuperview() } )
不推荐做法:
UIView.animateWithDuration(1.0) { self.myView.alpha = 0 } UIView.animateWithDuration(1.0, animations: { self.myView.alpha = 0 }, completion: { finished in self.myView.removeFromSuperview() } )
当单个闭包表达式上下文清晰时,使用隐式返回值:
UIView.animateWithDuration(1.0) { self.myView.alpha = 0 } UIView.animateWithDuration(1.0, animations: { self.myView.alpha = 0 }, completion: { finished in self.myView.removeFromSuperview() } )
类型
尽可能使用 Swift 原生类型。Swift 提供到 Objective-C 类型的桥接,所以你仍然可以使用许多需要的方法。
let width = 120.0 // Double let widthString = (width as NSNumber).stringValue // String
不推荐做法:
let width = 120.0 // Double let widthString = (width as NSNumber).stringValue // String
常亮
常量定义使用 let 关键字,变量定义使用 var 关键字,如果变量的值不需要改变,请尽量使用 let 关键字。
提示:一个好的技巧是,使用 let 定义任何东西,只有在编译器告诉我们值需要改变的时候才改成 var 定义。
可选类型
当nil值是可以接受的时候时,定义变量和函数返回值为可选类型(?)。
当你确认变量在使用前已经被初始化时,使用!来显式的拆包类型,比如在viewDidLoad中会初始化subviews。
当你访问一个可选值时,如果只需要访问一次或者在可选值链中有多个可选值时,请使用可选值链:
self.textContainer?.textLabel?.setNeedsDisplay()
当需要很方便的一次性拆包或者添加附加的操作时,请使用可选值绑定:
if let textContainer = self.textContainer { // do many things with textContainer }
当我们命名一个可选变量和属性时,避免使用诸如optionalString和maybeView这样的命名,因为可选值的表达已经在类型定义中了。
在可选值绑定中,直接映射原始的命名比使用诸如unwrappedView和actualLabel要好。
推荐做法
var subview: UIView? var volume: Double? // later on... if let subview = subview, volume = volume { // do something with unwrapped subview and volume }
不推荐做法:
var optionalSubview: UIView? var volume: Double? if let unwrappedSubview = optionalSubview { if let realVolume = volume { // do something with unwrappedSubview and realVolume } }
结构体构造器
使用原生的 Swift 结构体构造器,比老式的几何类(CGGeometry)的构造器要好。
推荐做法
let bounds = CGRect(x: 40, y: 20, width: 120, height: 80) let centerPoint = CGPoint(x: 96, y: 42)
不推荐做法
let bounds = CGRectMake(40, 20, 120, 80) let centerPoint = CGPointMake(96, 42)
推荐使用结构体限定的常量CGRect.infiniteRect,CGRect.nullRect等,来替代全局常量CGRectInfinite,CGRectNull等。对于已经存在的变量,可以直接简写成 .zeroRect
类型推断
推荐使用更加紧凑的代码,让编译器能够推断出常量和变量的类型。除非你需要定义一个特定的类型(比如CGFloat和Int16),而不是默认的类型。
推荐做法
let message = "Click the button" let currentBounds = computeViewBounds() var names = [String]() let maximumWidth: CGFloat = 106.5
不推荐做法
let message: String = "Click the button" let currentBounds: CGRect = computeViewBounds() var names: [String] = []
注意:遵守这条规则意味选择描述性命名比之前变得更加重要。
语法糖
推荐使用类型定义简洁的版本,而不是全称通用语法。
推荐做法:
var deviceModels: [String] var employees: [Int: String] var faxNumber: Int?
不推荐做法:
var deviceModels: Array<String> var employees: Dictionary<Int, String> var faxNumber: Optional<Int>
控制流
推荐循环使用for-in表达式,而不使用for-condition-increment表达式。
推荐做法:
for _ in 0..<3 { println("Hello three times") } for (index, person) in enumerate(attendeeList) { println("\(person) is at position #\(index)") }
不推荐做法
for var i = 0; i < 3; i++ { println("Hello three times") } for var i = 0; i < attendeeList.count; i++ { let person = attendeeList[i] println("\(person) is at position #\(i)") }
分号
Swift不需要在你代码中的每一句表达式之后添加分号。只有在你需要在一行中连接多个表达式中,使用分号来区隔。
不要在同一行编写多个使用分号区隔的表达式。
唯一的例外是在使用for-conditional-increment 架构。然而,尽可能使用for-in架构来替代它。
推荐做法:
let swift = "hello world"
不推荐做法
let swift = "hello world";
语言
推荐做法
let color = "red"
不推荐做法
let colour = "red"
版权声明
放在被包含的所在源文件顶部
注释
当你需要时,使用注释来解释一段特定的代码段的作用。注释必须保证更新或者及时删除。
避免在代码中使用块注释,代码尽可能自己能表达含义。以下情况除外:当使用注释来生成文档时。
类和结构体
选择使用谁?
请记住,结构体是值类型。使用结构体并没有一个标识。一个数组包含[a, b, c]和另外一个数组同样包含[a, b, c]是完全一样的,它们完全可以交换使用。使用第一个还是使用第二个无关紧要,因为它们代表的是同一个东西。这就是为什么数组是结构体。
类是引用类型。使用类是有一个标识或者有一个特定的生命周期。你需要对一个人类建模为一个类,因为两个不同的人的实例,是两个不同的东西。只是因为两个人有同样的名字和生日,也不能断定这两个人是一样的。但是人的生日是一个结构体,因为日期1950-3-3和另外一个日期1950-3-3是相同的。日期不需要一个标识。
有时,一些事物应该定义为结构体,但是需要兼容AnyObject或者已经在以前的历史版本中定义为类(NSDate,NSSet)。尽可能的尝试遵守这些规则。
定义的案例
class Circle: Shape { var x: Int, y: Int var radius: Double var diameter: Double { get { return radius * 2 } set { radius = newValue / 2 } } init(x: Int, y: Int, radius: Double) { self.x = x self.y = y self.radius = radius } convenience init(x: Int, y: Int, diameter: Double) { self.init(x: x, y: y, radius: diameter / 2) } func describe() -> String { return "I am a circle at \(centerString()) with an area of \(computeArea())" } override func computeArea() -> Double { return M_PI * radius * radius } private func centerString() -> String { return "(\(x),\(y))" } }
以上例子遵循了以下风格规范:
指定属性、变量、常量、参数定义或者其他定义的类型,在冒号后面,紧跟着一个空格,而不是把空格放在冒号前面。比如:x: Int和Circle: Shape。
如果能表示相同的目的和上下文,可以在同一行定义多个变量和结构体。
缩进getter,setter的定义和属性观察器的定义。
不需要添加internal这样的默认的修饰符。同样的,不需要在重写一个方法时添加访问修饰符。
self的使用
为了保持简洁,避免使用 self 关键词,Swift 不需要使用 self 来访问对象属性和调用对象方法。
必须使用 self 来区分构造器中属性命名和参数命名,还有在闭包表达式中引用属性值(编译器需要区分):
class BoardLocation { let row: Int, column: Int init(row: Int, column: Int) { self.row = row self.column = column let closure = { println(self.row) } } }
协议遵守
当我们对一个类添加协议时,推荐使用一个单独的类扩展来实现协议的方法。这可以保持协议相关的方法聚合在一起,同时也可以简单的标识出一个协议对应类中需要实现哪些对应的方法。
同时,别忘了添加// MARK:,注释可以使得代码组织的更好!
推荐做法:(要区别OC)
class MyViewcontroller: UIViewController { // class stuff here } // MARK: - UITableViewDataSource extension MyViewcontroller: UITableViewDataSource { // table view data source methods } // MARK: - UIScrollViewDelegate extension MyViewcontroller: UIScrollViewDelegate { // scroll view delegate methods }
不推荐做法
class MyViewcontroller: UIViewController, UITableViewDataSource, UIScrollViewDelegate { // all methods }
计算属性
为了保持简洁,如果一个计算属性是只读的,请忽略掉get语句。只有在需要定义set语句的时候,才提供get语句。
推荐做法
var diameter:Double{ return radius * 2 }
不推荐做法
var diameter:Double{ get{ return radius * 2 } }
相关文章推荐
- 峰回路转,Firefox 浏览器即将重返 iOS 平台
- 峰回路转,Firefox 浏览器即将重返 iOS 平台
- 不可修补的 iOS 漏洞可能导致 iPhone 4s 到 iPhone X 永久越狱
- iOS 12.4 系统遭黑客破解,漏洞危及数百万用户
- Apple Swift学习教程
- 每日安全资讯:NSO,一家专业入侵 iPhone 的神秘公司
- [转][源代码]Comex公布JailbreakMe 3.0源代码
- 介绍 Fedora 上的 Swift
- 讲解iOS开发中基本的定位功能实现
- iOS中定位当前位置坐标及转换为火星坐标的方法
- js判断客户端是iOS还是Android等移动终端的方法
- iOS应用开发中AFNetworking库的常用HTTP操作方法小结
- iOS应用中UISearchDisplayController搜索效果的用法
- iOS App开发中的UISegmentedControl分段组件用法总结
- IOS开发环境windows化攻略
- iOS应用中UITableView左滑自定义选项及批量删除的实现
- iOS中UIAlertView警告框组件的使用教程
- 浅析iOS应用开发中线程间的通信与线程安全问题