免費(fèi)AI編程助手
Swift 編程風(fēng)格指南
語言
使用美式英語拼寫以匹配蘋果公司的API
優(yōu)選：
var color = "red"不建議使用：
var colour = "red"間隔
- 使用2個空格進(jìn)行縮進(jìn)而不是使用Tab，這樣可以節(jié)省空格，阻止換行。確保在Xcode的配置項中進(jìn)行了設(shè)置。
- 方法的花括號以及其它花括號（
if/else/switch/while等等）總是跟語句在同一行開始，但是在新的一行中結(jié)束。
優(yōu)選：
if user.isHappy {
//Do something
} else {
//Do something else
}不建議使用：
if user.isHappy
{
//Do something
}
else {
//Do something else
}- 方法之間應(yīng)該總是用一空白行進(jìn)行分隔以提高視覺以及結(jié)構(gòu)上的清晰度。方法中的空白符用來隔離功能塊，但是如果一個方法中存在太多這種功能塊時，通常也意味著你需要將它重構(gòu)為多個方法了。
注釋
- 在需要的時候使用注釋說明一塊代碼為什么這么做。注釋必須時刻跟進(jìn)代碼，不然刪了得了。
- 因為代碼應(yīng)該盡可能的自文檔化，所以避免在代碼中使用成塊的注釋。例外：該規(guī)則不適用與用于生成文檔的成塊注釋。
命名
使用駝峰法為類、方法、變量等等取一個描述性強(qiáng)的名字。模塊范圍的類名以及常量名稱要以大寫字母開頭，而方法名跟變量名則應(yīng)該以小寫字母開頭。
優(yōu)選：
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
}對于普通函數(shù)以及構(gòu)造函數(shù)名稱，除非上下文含義非常清楚，對所有的參數(shù)都加以命名是更為推薦的做法。如果外部參數(shù)名稱可以使得函數(shù)調(diào)用更具有可讀性，那么請帶上它。
func dateFromString(dateString: NSString) -> NSDate
func convertPointAt(#column: Int, #row: Int) -> CGPoint
func timedAction(#delay: NSTimeInterval, perform action: SKAction) -> SKAction!
// 會被這樣調(diào)用
dateFromString("2014-03-14")
convertPointAt(column: 42, row: 13)
timedAction(delay: 1.0, perform: someOtherAction)對于方法，遵循蘋果公司的命名標(biāo)準(zhǔn)，在方法名中提及第一個參數(shù)：
class Guideline {
func combineWithString(incoming: String, options: Dictionary?) { ... }
func upvoteBy(amount: Int) { ... }
}在所有提及到函數(shù)的內(nèi)容中（包括教程，書以及評論），請從調(diào)用者的視角進(jìn)行考慮，將所有的必要參數(shù)名都包含進(jìn)來：
dateFromString()函數(shù)真是太棒了。
在你的init()方法中調(diào)用convertPointAt(column:, row:)。
timedAction(delay:, perform:)的返回值可能為nil。
Guideline對象只有兩個方法：combineWithString(options:)跟upvoteBy()。
你不應(yīng)該直接調(diào)用數(shù)據(jù)源方法tableView(cellForRowAtIndexPath:)。類前綴
Swift中的類型會自動加入包含它們的模塊的命名空間。所以即使是為了最小化命名沖突的可能性，前綴也是不必要的。如果來自于不同模塊的兩個名稱沖突了，可以通過在名稱前面加上模塊名以消除歧義：
import MyModule
var myClass = MyModule.MyClass()不應(yīng)該在自己創(chuàng)建的類型上加前綴。
如果需要將Swift類型暴露在Objective-C環(huán)境中使用，請按照以下方式提供合適的前綴（前綴的命名請參考Objective-C風(fēng)格指南）:
@objc (RWTChicken) class Chicken {
...
}分號
Swift中，每條語句后的分號都不是必需的。只有在一行中有多條語句時才需要添加上分號。
請不要在一行中寫上用分號隔開的多條語句。
這條規(guī)則的唯一例外就是for-conditional-increment結(jié)構(gòu)，該結(jié)構(gòu)中分號是必需的。不過，請盡可能地使用另外一種結(jié)構(gòu)，for-in循環(huán)。
優(yōu)選：
var swift = "not a scripting language"不建議使用：
var swift = "not a scripting language";請注意：Swift與JavaScript不同, 在后者中省略分號通常是不安全的。
類與結(jié)構(gòu)體
下面的代碼是一個很有標(biāo)準(zhǔn)范兒的類定義，請參考：
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 (\(x),\(y)) with an area of \(computeArea())"
}
func computeArea() -> Double {
return M_PI * radius * radius
}
}上面的例子闡述了這么幾個風(fēng)格上的準(zhǔn)則：
- 當(dāng)為屬性、變量、常量、參數(shù)聲明以及其它語句等定義類型時，而冒號的后面加上空格而不是前面，比如：
x: Int跟Circle: Shape。 - 要對getter跟setter定義以及屬性觀察器進(jìn)行縮進(jìn)。
- 如果多個變量、結(jié)構(gòu)有著同樣的目的或者上下文，在同一行上進(jìn)行定義。
Self
考慮到在Swift中訪問一個對象的屬性或者調(diào)用它的方法并不需要使用self，所以請避免使用它。
需要使用self的唯一理由就是在初始化一個類或者結(jié)構(gòu)體時，使用其在屬性名和參數(shù)之間加以區(qū)分：
class BoardLocation {
let row: Int, column: Int
init(row: Int,column: Int) {
self.row = row
self.column = column
}
}函數(shù)聲明
保持函數(shù)聲明短小精悍，盡量在一行中完成聲明，同時還包含了開括號：
func reticulateSplines(spline: Double[]) -> Bool {
// reticulate code goes here
}對于有著長長的參數(shù)的函數(shù)，請在適當(dāng)?shù)奈恢眠M(jìn)行斷行且對后續(xù)行縮進(jìn)一級：
func reticulateSplines(spline: Double[], adjustmentFactor: Double,
translateConstant: Int, comment: String) -> Bool {
// reticulate code goes here
}閉包
盡可能地使用尾閉包語法。在所有的情況下都需要給閉包參數(shù)一個描述性強(qiáng)的名稱：
return SKAction.customActionWithDuration(effect.duration) { node, elapsedTime in
// more code goes here
}對于上下文清晰的單表達(dá)式閉包，使用隱式的返回值：
attendeeList.sort { a, b in
a > b
}類型
盡可能地使用Swift原生類型。Swift提供了對Objective-C的橋接所以在需要的時候仍然可以使用全部的Objective-C方法：
優(yōu)選：
let width = 120.0 //Double
let widthString = width.bridgeToObjectiveC().stringValue //String不建議使用：
let width: NSNumber = 120.0 //NSNumber
let widthString: NSString = width.stringValue //NSString在Sprite Kit的代碼中，如果CGFloat可以避免過多的轉(zhuǎn)換而使得代碼簡潔明了，那么請用上它。
常量
常量通過let關(guān)鍵字定義，而變量使用var關(guān)鍵字定義。任何值如果是一個不變量，那么請使用let關(guān)鍵字恰如其分地定義它。最后你會發(fā)現(xiàn)自己喜歡使用let遠(yuǎn)多于far。
Tip：有一個方法可以幫你符合該項規(guī)則，將所有值都定義成常量，然后編譯器提示的時候?qū)⑵涓臑樽兞俊?/p>
Optionals
在nil值可能出現(xiàn)的情況下，將變量跟函數(shù)返回值的類型通過?定義成Optional。
只有在確定實(shí)例變量會在初始化之后才被使用的情況下，通過!將其定義為隱式解包類型（Implicitly Unwrapped Types），比如說會在viewDidLoad中被創(chuàng)建的子視圖。
在訪問一個Optional值時，如果該值只被訪問一次，或者之后需要連續(xù)訪問多個Optional值，請使用鏈?zhǔn)絆ptional語法：
myOptional?.anotherOne?.optionalView?.setNeedsDisplay()對于需要將Optional值解開一次，然后進(jìn)行多個操作的情況，使用Optional綁定更為方便：
if let view = self.optionalView {
// do many things with view
}類型推斷
Swift的編譯器可以推斷出變量跟常量的類型?？梢酝ㄟ^類型別名（在冒號后面指出其類型）提供顯式類型，不過大多數(shù)情況下這都是不必要的。
保持代碼緊湊，然后讓編譯器推斷變量跟常量的類型。
優(yōu)選：
let message = "Click the button"
var currentBounds = computeViewBounds()不建議使用：
let message: String = "Click the button"
var currentBounds: CGRect = computeViewBounds()注意：遵循這條準(zhǔn)則意味著描述性強(qiáng)的名稱比之前更為重要了。
控制流
對于for循環(huán)，優(yōu)選for-in風(fēng)格而不是for-condition-increment風(fēng)格：
優(yōu)選：
for _ in 0..5 {
println("Hello five times")
}
for person in attendeeList {
// do something
}不建議使用：
for var i = 0; i < 5; i++ {
println("Hello five times")
}
for var i = 0; i < attendeeList.count; i++ {
let person = attendeeList[i]
// do something
}笑臉
笑臉對于raywenderlich.com來說是一個格外重要的風(fēng)格特征。使用正確的笑臉可以表示出對某個主題的無窮盡的高興以及興奮程度。選用了]是因為它在ASCII藝術(shù)可以表示得最大的笑臉。而閉圓括號)因為給人一種“呵呵”的感覺而不建議使用。
優(yōu)選：
:]不建議使用：
:)
更多建議：