前言
開發時總會遇到一些反覆要寫的代碼,比如 UITableView 的資料來源與代理方法。一般情況下我們要嘛自己敲,要嘛從舊專案複製貼上。其實 Xcode 提供了一個更好的選擇:Code Snippet(代碼片段)功能,只要敲幾個字母就能展開預先設定好的一整段代碼。本文分享一批常用片段,並說明如何自訂。
一、常用內建寫法
1. strong 屬性
@property (nonatomic, strong) <#Class#> *<#object#>;
2. weak 屬性
@property (nonatomic, weak) <#Class#> *<#object#>;
3. copy 屬性
@property (nonatomic, copy) NSString *<#string#>;
4. assign 屬性
@property (nonatomic, assign) <#Class#> <#property#>
5. delegate
@property (nonatomic, weak) id<<#protocol#>> <#delegate#>
6. block 屬性
@property (nonatomic, copy) <#Block#> <#block#>
7. MARK 註記
#pragma mark <#mark#>
8. 表格 cell 複用
static NSString *rid = <#rid#>;
<#Class#> *cell = [tableView dequeueReusableCellWithIdentifier:rid];
if (cell == nil) {
cell = [[<#Class#> alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:rid];
}
return cell;
9. 主執行緒非同步派發
dispatch_async(dispatch_get_main_queue(), ^{
<#code#>
});
10. 延遲執行
dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(<#delayInSeconds#> * NSEC_PER_SEC)),
dispatch_get_main_queue(), ^{
<#code to be executed after a specified delay#>
});
11. 只執行一次
static dispatch_once_t onceToken;
dispatch_once(&onceToken, ^{
<#code to be executed once#>
});
二、自訂代碼片段
以 strong 屬性為例,流程如下:
1. 先在代碼中寫出目標語句:
@property (nonatomic, strong) <#Class#> *<#object#>
2. 選中該行,用滑鼠左鍵拖曳到 Xcode 右側的 Code Snippet Library 區域,即完成新增。

3. 放開滑鼠後會彈出編輯視窗:

各欄位含義依序是:
① Title:代碼片段的標題;
② Summary:片段的描述文字;
③ Platform:可用的平台,有 iOS / OS X / All 三個選項;
④ Language:可在哪些語言中使用;
⑤ Completion Shortcut:呼叫片段的快捷字,例如 copy;
⑥ Completion Scopes:可在哪些位置觸發,例如全檔案、僅標頭檔等,支援多選。
最下方的大片空白區域是效果預覽。設定完成後點擊右下角的 Done 即可。
代碼片段的備份與遷移
Xcode 的代碼片段預設存放在:
~/Library/Developer/Xcode/UserData/CodeSnippets
把這個目錄整個複製出來備份,或直接拷到另一台電腦的相同路徑,就能帶著自己累積的片段走。團隊內也可以透過共享這個目錄來統一常用模板。