XCode 使用技巧

官方工具 x 你所不知道的開發功能

前言 : 何時才能愉快的寫 Code ?

學習 iOS 的開發有不少的門檻，除了必須先有一台 Mac 電腦，還要熟悉 Swift 語法與 iOS SDK。

好不容易入手了 Mac，第一個遇到的困難點，就是陌生的開發工具 XCode。

還好 不像學習「程式語言」，需要許多的「時間」與「耐心」，開發工具的使用是可以速成的。
而且 XCode 除了免費之外，還是 Apple 官方的開發工具，本身也是個具有特色且功能強大的軟體 !

這次的教程直接看影片會比較快了解功能作用，
此篇文章除了必要的說明外，只會簡單列表影片中出現的快捷鍵，以供後續遺忘時可以快速回顧。

源起 XVim2 插件

這次的 XCode 開發指南，起源於我在 XCode 安裝 Vim 的插件「 XVim2 」

XVim2

https://github.com/XVimProject/XVim2

安裝時，必要的「證書簽入」動作與 MacOS 最新版本的 Big Sur 安全機制衝突，導致發生開發者帳號無法登入，也無法安裝到實體手機的狀況發生。

安全機制衝突

https://github.com/XVimProject/XVim2/issues/340

不得已只能重新安裝，並且在不熟悉工具的情況下，進行開發。

替代方案

在尋找的過程中，我發現部分的 XCode 快捷鍵模式是屬於 emacs 類型

例如:

方向鍵上下左右是 control + P/N/B/F
光標移動到行首是 control + A
刪除字符到行尾是 control + K
組合使用 control + AKK 就代表刪除單行文字

最大限度熟悉 XCode 的功能與快捷鍵也成為選項之一。

指南內容

集合網路上搜集到的各種 XCode 使用技巧與對映我使用 IntelliJ 與 Vim 的經驗，整理從面板、導航一直到執行、除錯與自定義快捷鍵的各項功能。

我認為熟悉這個工具的使用，對於開發者來說會是個合理且划算的投資

(Apple 系列產品 : macOS、iOS、iPadOS、WatchOS、tvOS)

開發環境

作業系統

macOS Big Sur 11.2 版本

開發者工具

XCode 12.4 版本

近期開發的 Side Project

Swift 語法
SwiftUI 框架

所以只會針對這個語法與框架的專案，介紹相關的功能與快捷鍵操作，
如果沒有看到 Storyboard 的設計介面與 Object-C 語法的相關操作是正常的情況，這些部分這次就不會介紹。

面板

功能面板

cmd + 0 : 導航欄
cmd + opt + 0 : 檢視器
cmd + shift + y : 除錯區

功能面板 : 導航細節

cmd + 1 : Project
cmd + 2 : Source Control
cmd + 3 : Symbols
cmd + 4 : Find
cmd + 5 : Issues
cmd + 6 : Tests
cmd + 7 : Debug
cmd + 8 : Breakpoints
cmd + 9 : Report

功能面板 : 檢視器細節

cmd + opt + 1 : File
cmd + opt + 2 : History
cmd + opt + 3 : Quick Help
cmd + opt + 4 : Attributes

功能面板 : 控制區細節

cmd + shift + C : 控制臺
cmd + shift + Y : 除錯區

(除錯區右下方的兩個圖示按鈕，可以決定哪一項的功能完整顯示)

SwiftUI 框架 : 預覽視窗

cmd + opt + enter : 畫布

編輯器 : 輔助視窗

cmd + enter : 只顯示編輯器

一次性的關閉當前所有的輔助功能
(右上角列表圖示，開啟的輔助功能都一併關閉)

檔案導航

cmd + shift + J : 在導航欄聚焦檔案
cmd + opt + J : 聚焦導航過濾器
cmd + shift + O : 快速開啟

補充 :

cmd + shift + J :
此快捷鍵要在有開啟檔案的情況下才能作用，
因為該功能其實是在導航列中聚焦當前檔案，如果面板中沒有檔案的話只能用 cmd + 1。

編輯區塊 :

編輯區塊的左上角，四個方格的圖示 :

此部分的快捷鍵功能 :

control + 1 : Related Items
control + 2 : Previous Files History 之前歷史
control + 3 : Next Files History 之後歷史
control + 4 : Top Level Items 頂層的目錄向下尋找
control + 5 : Group Files 同層級目錄
control + 6 : Document Items 函式結構

分頁與視窗

個人覺得是個非常具有特色的功能

分頁

左側列表選擇檔案後，不像其他編輯器只是單純聚焦或者開啟分頁，而是會隨著選擇變換分頁中的內容，
要滑鼠點擊兩次才會加入到分頁上。

分頁的名稱上，有的文字是傾斜，有的文字是正常，傾斜文字就是會隨著選擇而變動的分頁。

可以理解為:

這個是文檔的快速預覽功能，需要再多一個動作(點擊兩下)才會真正加入到分頁上。

cmd + shift + J : 跳到列表
cmd + opt + O : 開啟在分頁上

分頁操作

• control + ` : 聚焦回編輯區塊
• cmd + shift + [ : 分頁向左切換
• cmd + shift + ] : 分頁向右切換
• cmd + w : 關閉當前分頁
• cmd + opt + w : 關閉其他分頁

(關閉全部分頁 : cmd + shift + w 已經有其他功能使用，替代分案 : 組合使用 cmd + opt + w , cmd + w)

輔助編輯器

cmd + control + T : 開啟輔助編輯器

開啟在輔助編輯器

• 滑鼠操作 : opt + 點擊
• 鍵盤操作 : cmd + opt + ,
• cmd + opt + shift + , : 選擇位置開啟

按住 opt 後 Enter 開啟 : 
    - cmd + shift + O : Open Quickly
    - control + 1 : Related Items
    - control + 2 : Previous Files History
    - control + 3 : Next Files History
    - control + 4 : Top Level Items
    - control + 5 : Group Files

輔助編輯器操作

編輯區塊切換 : 
    - control + ` : 編輯視窗順序切換
    - cmd + opt + ` : 功能區塊順序切換
    - cmd + J : 選擇編輯區塊

聚焦於當前編輯區塊 : 
    - cmd + control + shift + enter
    (暫時隱藏原先的視窗狀態並不會關閉，左上角的傾斜的雙箭頭圖示顯示狀態)

關閉輔助編輯器 : 
    - cmd + control + shift + W

視窗分頁

cmd + T : 開啟視窗分頁

這個分頁拉出來也是一個獨立的編輯器，可以這樣理解:

這個分頁就是另外一個獨立的工作區，不會去共用側邊欄的導覽 或者 近期檔案的導航功能

視窗分頁操作

視窗分頁切換 :
    - control + tab : 順序切換
    - control + shift + tab : 反向切換

重新命名視窗分頁 : 
    - cmd + opt + shift + T
    (可以一次性的使用 3 ~ 5 個分頁搭配重新命名，可以更好的組織邏輯與思緒)

關閉視窗分頁 : 
    - cmd + shift + W

代碼導航

開頭時曾介紹過的 emacs 類型快捷鍵 :

control + P : 向上
control + N : 向下
control + B : 向左
control + F : 向右
control + A : 到行首
control + E : 到行尾

Mac 電腦通用的光標移動功能 :

cmd + ↑ : 頁面頂端
cmd + ↓ : 頁面底端
cmd + ← : 文字開頭
cmd + → : 文字結尾
opt + ← : 單字左側
opt + → : 單字右側
opt + ↑ : 上一段落 (不常用)
opt + ↓ : 下一段落 (不常用)

大範圍的移動

cmd + L : 行數跳轉
cmd + opt + L : 跳轉到光標處
cmd + control + J : 跳轉到定義處

文件項目 : 過濾器

control + 6 -> 輸入函式名稱

關聯項目 : Callers & Callees

Callers : 哪些類別與方法調用此類別
Callees : 哪些類別與方法被此類別調用

特殊情況

特殊情況 01 : 版本控制的狀態

點擊右上角的雙向箭頭圖示，會在當前畫面中呈現版本比對的訊息 :

control + \ : 可以修改區塊進行快速跳轉

(版本比對要關閉，不然快捷鍵無法生效)

特殊情況 02 : 編譯錯誤的狀態

cmd + ' : 順序跳轉到下一個錯誤位置
cmd + shift + ' : 反向跳轉到上一個錯誤位置

查詢與替代功能

cmd + F : 開啟查詢面板
cmd + opt + F : 開啟替代面板
cmd + E : 填入搜尋框
cmd + shift + E : 填入替代框
cmd + G : 下一筆結果
cmd + shift + G : 上一筆結果

使用選取文字搜尋

cmd + opt + E : 下一筆
cmd + opt + shift + E : 上一筆

以專案為範圍

cmd + shift + f : 搜尋
cmd + opt + shift + f : 替代

同樣可以使用填入文字的快捷鍵 :
    - cmd + E : 搜尋框
    - cmd + shift + E : 替代框

編輯

基礎編輯

control + i : 選取代碼排版
cmd + / : 光標代碼註解

排版補充

cmd + ] : 向右縮排
cmd + [ : 向左縮排
cmd + opt + ] : 向上移動文字
cmd + opt + [ : 向下移動文字

註解補充

cmd + opt + / : 添加文檔註解

代碼編輯 emacs 類型

control + D : 反向刪除字元
control + K : 刪除到結尾文字
control + T : 交換光標兩側文字

目前查到 XCode 中，已知的 emacs 類型 :

• control + P : 向上
• control + N : 向下
• control + B : 向左
• control + F : 向右
• control + A : 到行首
• control + E : 到行尾
• control + L : 跳轉到光標處
• control + D : 反向刪除字元
• control + K : 刪除到結尾文字
• control + T : 交換光標兩側文字

(之後若有發現更多的功能，會在此部分補充)

批量修改變數名稱

三種操作

01. 滑鼠操作

右鍵 > refactor > rename

02. 鍵盤操作

cmd + shift + A > rename

03. 在範圍中編輯全部

cmd + control + E

該功能僅適用於單一檔案快速修改，若已經被外部參照，要使用 rename 才會連動修改

XCode 智能補全

初始化方法補全

選單 : Editor > Refactor > Generate Memberwise Initializer

(光標要定位於類別名稱)

方法補全

ESC : 手動顯示提示選單
control + . : 順序切換
control + shift + . : 反向切換
control + / : 選擇確認

修正連續技

cmd + ' : 跳轉到錯誤位置
cmd + opt + control + F : 編輯器補全修正

多行編輯功能

三種操作

opt 按住 + 滑鼠拖移
control + shift + ↑ / ↓
control + shift + 滑鼠點擊

執行與除錯

執行

cmd + R : 執行程式
cmd + B : 編譯程式
cmd + . : 停止程式
cmd + shift + K : 清除系統資源

除錯

cmd + \ : 設置中斷點
cmd + Y : 開關除錯模式

Debug 模式的部份，我使用的機率沒有很高，那為什麼要說明這兩項功能 ?

因為我查到的資料中有些開發者，由於 XCode 沒有書籤功能，所以會使用這個中斷點來替代使用
我個人是覺得如果能夠熟練的使用「分頁與視窗」功能，使用中斷點來替代，看起來就沒有那麼的必要。

自定義

按鍵「 cmd + , 」打開設置後「 Key bindings 」

個人配置了6 + 1 的快捷鍵，來輔助開發。

「六項」已經有的功能，沒有預設成快捷鍵 `6`

頁面上下移動

control + U : 頁面向上
control + J : 頁面向下

區塊選取文字

選取單字 : control + C
選取單行 : cmd + shift +

重新命名

cmd + opt + 6

刪除單行

control + S

「一項」沒有的功能，修改配置擴增快捷鍵 `+1`

XCode 配置檔路徑

/Applications/Xcode.app/Contents/Frameworks/IDEKit.framework/Resources/IDETextKeyBindingSet.plist

權限調整指令

sudo chmod 666 /Applications/Xcode.app/Contents/Frameworks/IDEKit.framework/Resources/IDETextKeyBindingSet.plist
sudo chmod 777 /Applications/Xcode.app/Contents/Frameworks/IDEKit.framework/Resources/

編輯配置檔

vim /Applications/Xcode.app/Contents/Frameworks/IDEKit.framework/Resources/IDETextKeyBindingSet.plist

(也可以使用 open 指令，用 XCode 介面編輯，或者直接進入到檔案目錄用其他編輯器修改)

複製指令

selectLine:, copy:, moveToEndOfLine:, insertNewline:, paste:, deleteBackward:

修改後的配置內容

<key>EnoxsIDE</key>
<dict>
    <key>Duplicate Line</key>
    <string>selectLine:, copy:, moveToEndOfLine:, insertNewline:, paste:, deleteBackward:</string>
</dict>

重啟後，設置

cmd + D : 複製單行

原本的預設中也有一個 Duplicate 的功能「cmd + D」
只是在編輯器中試不出來，所以只好把這個快捷鍵，移到新配置的 Duplicate Line

結尾 : 時間與耐心

上述從基礎面板、檔案導航、分頁視窗、代碼導航、代碼編輯、執行除錯以及最後的自定義功能。

你應該已經知道 XCode 可以做的事情遠比想像中的多更多。

不過熟悉開發工具的使用是開發中「可選」的條件，卻並不是「必要」的條件。

例如 : 我最近正在開發的 iOS App `Side Project`

在 XVim2 的插件發生問題以後，只知曉左右側與下方面板開關以及註解、排版、執行，

這六個快捷鍵的情況下，就已經陸續的完成將近七至八成的內容。

要完整的開發一個 iOS App 熟悉工具的使用只能錦上添花，但並不能完全替代所有必備的知識。

這些就只能透過足夠多的「時間」與「耐心」以及「正確的方法」(Gamma Ray 軟體工作室) 逐步累積知識。

我相信，最終肯定可以到達愉快寫 Code 的程度 !

參考資料