raywenderlich.com的Swift编程风格指南
Posted clnchanpin
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了raywenderlich.com的Swift编程风格指南相关的知识,希望对你有一定的参考价值。
翻译自:https://github.com/raywenderlich/swift-style-guide
这个风格指南可能和你从其它地方看到的不同,我们的焦点主要集中在互联网和文章上的可读性。创建这个编程风格指南是为了保持我们的书籍、教程和入门工具包中代码的优雅与一致性------虽然我们有和很多不同的作者合作。
我们的首要目的是简洁、可读性和简单。
你在写Objective-C吗?看看我们的Objective-C风格指南吧。
文件夹
命名
建议:
let MaximumWidgetCount = 100 class WidgetContainer { var widgetButton: UIButton let widgetHeightPercentage = 0.85 }
不建议:
let MAX_WIDGET_COUNT = 100 class app_widgetContainer { var wBut: UIButton let wHeightPct = 0.85 }
func dateFromString(dateString: NSString) -> NSDate func convertPointAt(column: Int, row: Int) -> CGPoint func timedAction(delay: NSTimeInterval, perform action: SKAction) -> SKAction! // would be called like this: dateFromString("2014-03-14") convertPointAt(column: 42, row: 13) timedAction(delay: 1.0, perform: someOtherAction)对于方法而言。依照Apple的习惯,在方法名里引用第一个參数:
class Guideline { func combineWithString(incoming: String, options: Dictionary?) { ... } func upvoteBy(amount: Int) { ... } }当我们在文章中须要引用方法的地方,要从调用者的角度包括全部必须的參数名。假设上下文非常清晰。并且准确的方法签名不重要时。你就能仅仅用法名。
类前缀
import MyModule var myClass = MyModule.MyClass()你不应该为Swift类型加上前缀。
@objc (RWTChicken) class Chicken { ... }
间隔
- 使用2个空格来缩进,而不是用tab,这能够节省空间,并有助于防止换行。
请务必在Xcode的偏好设置里设置。
- 方法的大括号和其它语句的大括号(if / else / switch / while等等)总是和语句在同一行打开,在新的一行关闭。
建议:
if user.isHappy { //Do something } else { //Do something else }
不建议:
if user.isHappy { //Do something } else { //Do something else }
- 在方法之间应该正好有一个空行。这能使结构看起来更加清晰。
在方法内用空行分隔功能。但假设分隔成太多段的话,经常意味着你须要把一个方法重构成多个方法。
凝视
类和结构体
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。
- 对于多个变量,假设它们有相同的结构和上下文环境(比方x、y),则把它们定义在同一行。
- 缩进属性(property)的getter/setter定义。
- 不要加入像interal这种默认修饰符。相同的,当覆盖一个方法时。不要在方法上再次写上它的訪问修饰符。
Self的使用
class BoardLocation { let row: Int, column: Int init(row: Int,column: Int) { self.row = row self.column = column } }
函数定义
func reticulateSplines(spline: [Double]) -> Bool { // reticulate code goes here }对于拥有长签名的函数,在合适的地方加入一个换行符。并为随后的几行加入一个额外的缩进:
func reticulateSplines(spline: [Double], adjustmentFactor: Double, translateConstant: Int, comment: String) -> Bool { // reticulate code goes here }
闭包
在不论什么情况下,给闭包中的參数具有描写叙述性的名称:
return SKAction.customActionWithDuration(effect.duration) { node, elapsedTime in // more code goes here }对上下文清晰的单行表达式闭包,使用隐式的return:
attendeeList.sort { a, b in a > b }
类型
Swift提供了桥接(Bridging)到Objective-C的功能,在须要时你也能使用Objective-C的完整方法:
建议:
let width = 120.0 //Double let widthString = (width as NSNumber).stringValue //String
不建议:
let width: NSNumber = 120.0 //NSNumber let widthString: NSString = width.stringValue //NSString在使用Sprite Kit的代码里,使用CGFloat能使代码更加简洁,同一时候能避免太多的类型转换。
常量
Optional
myOptional?假设想更方便的做一次拆包然后运行多个操作。用Optional Binding:.anotherOne?.optionalView?.setNeedsDisplay()
if let view = self.optionalView { // do many things with view }
结构体的初始化
建议:
let bounds = CGRect(x: 40, y: 20, width: 120, height: 80) var centerPoint = CGPoint(x: 96, y: 42)
不建议:
let bounds = CGRectMake(40, 20, 120, 80) var centerPoint = CGPointMake(96, 42)
类型判断
建议:
let message = "Click the button" var currentBounds = computeViewBounds()
不建议:
let message: String = "Click the button" var currentBounds: CGRect = computeViewBounds()备注:依照本原则:取一个具有描写叙述性的名字比什么都要重要。
语法糖
建议:
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 0..<3 { println("Hello three times") } for person in attendeeList { // do something }
不建议:
for var i = 0; i < 3; i++ { println("Hello three times") } for var i = 0; i < attendeeList.count; i++ { let person = attendeeList[i] // do something }
分号
建议:
var swift = "not a scripting language"
不建议:
var swift = "not a scripting language";备注:Swift与javascript有非常大不同,在JavaScript里省略分号通常被觉得是不安全的。
语言
建议:
var color = "red"
不建议:
var colour = "red"
笑脸
建议:
:]
不建议:
:)
功臣
- Soheil Moayedi Azarpour
- Scott Berrevoets
- Eric Cerney
- Sam Davies
- Evan Dekhayser
- Jean-Pierre Distler
- Colin Eberhardt
- Greg Heo
- Matthijs Hollemans
- Erik Kerber
- Christopher LaPollo
- Andy Pereira
- Ryan Nystrom
- Cesare Rocchi
- Ellen Shapiro
- Marin Todorov
- Chris Wagner
- Ray Wenderlich
- Jack Wu
以上是关于raywenderlich.com的Swift编程风格指南的主要内容,如果未能解决你的问题,请参考以下文章
在类 HKManager (HKTutorial) 中完成的函数 readRunningWorkOuts 永远不会在 Swift 3 中执行
在类 HKManager (HKTutorial) 中完成的函数 readRunningWorkOuts 永远不会在 Swift 3 中执行
Firebase + Swift 删除 TableView 中的行