iOS 註釋方法大全 程式碼塊加快捷鍵自定義註釋

臭碼農發表於2017-12-14

註釋規範

      良好的編碼規範是程式設計師必備的素質,編碼中的程式碼註釋尤為重要,健全的程式碼註釋可以提高程式碼可讀性和維護性,不僅為了標識此塊程式碼的含義,很多時候包含了對業務邏輯的解釋,專案中難免有邏輯複雜之處,不加註釋的程式碼,數日後自己看都會覺得陌生,更不要說其他人看了,今天分享一下Objective-C開發中常用的程式碼註釋方式以及應用場合。

註釋形式

註釋形式主要有:

單行註釋,多行註釋,方法註釋,方法集註釋(配合程式碼塊實現快速註釋)

1. 單行註釋

使用 // 註釋單行程式碼,最常見的使用場景是在方法內註釋某個屬性或某塊區域的含義,如下圖:


iOS 註釋方法大全 程式碼塊加快捷鍵自定義註釋

2. 多行註釋

使用 /** 文字 **/ 的註釋格式(快捷鍵cmd+alt+/)可以對屬性和類以及方法進行註釋,與//不同的是,該註釋方式可以寫多行,一般使用在類的標頭檔案,多行介紹當前類的含義,如下圖:

iOS 註釋方法大全 程式碼塊加快捷鍵自定義註釋

3. 方法註釋

與方法2相同,使用 /** 文字 **/ 的註釋格式(快捷鍵cmd+alt+/)可以對方法進行註釋,快捷鍵會根據方法引數自動生成需要填寫的註釋內容,並且在其他地方使用該方法時,Xcode會智慧提示出之前寫的註釋內容,如下圖:

在方法上方使用快捷鍵 cmd+alt+/:

iOS 註釋方法大全 程式碼塊加快捷鍵自定義註釋

使用該方法時顯示註釋內容:

iOS 註釋方法大全 程式碼塊加快捷鍵自定義註釋

4:方法集註釋(配合程式碼塊實現快速註釋)

先介紹一下,何為方法集註釋,通常沒有新增方法集的類是這樣的:

iOS 註釋方法大全 程式碼塊加快捷鍵自定義註釋

為了快速定位類中的某塊程式碼,或某個方法,Xcode為我們提供了方法集的註釋方式,可大大減少搜尋目的碼的時間,如圖:

iOS 註釋方法大全 程式碼塊加快捷鍵自定義註釋

這樣就能對類中的方法和模組一覽無餘,要查詢或修改的時候可以迅速定位,節省時間,提高自我體驗。

實現方法:

#pragma mark  <#註釋的內容#>

#pragma mark -  <#註釋的內容#>

加上橫線代表這是一塊區域,在預覽時有灰色分割線,反之則沒有。

但是每次敲這些字元一定不是你想要的效果,在Xcode8之前可以使用VVDocumenter增強版(個人在原基礎上修改新增方法集註釋功能),由於Xcode8預設禁用使用外掛,所以我們採用程式碼塊+快捷鍵的方式來實現,效果也是酸爽:

iOS 註釋方法大全 程式碼塊加快捷鍵自定義註釋

上圖中,就是我使用程式碼塊+快捷鍵來實現的方法集註釋,編寫方便,快捷,具體實現步驟如下:

在任何一個 .m 檔案中,敲出自己要定義的程式碼塊,例如:

#pragma mark -  <#註釋的內容#>

滑鼠選中上述程式碼,按住左鍵 1秒鐘,然後拖到右下方程式碼塊區域

並設定快捷鍵:

iOS 註釋方法大全 程式碼塊加快捷鍵自定義註釋

這樣就大功告成,儲存程式碼塊,在程式碼中使用預設的快捷鍵,編譯器會自動提示,回車,輸入即可。

注意:

在.h中建立的程式碼塊會導致在.m中無法使用,而在.m中建立的可以通用。

必須按住一秒再拖動,否則會拖不了

使用 <# 自定義註釋內容 #> 這樣打出來的提示,可以使用Tab鍵快速轉到

iOS 註釋方法大全 程式碼塊加快捷鍵自定義註釋
快捷鍵程式碼塊快速註釋


以上屬於臭碼農原創,若有雷同屬巧合,如有錯誤望指正,轉載請標明來源和作者。by:臭碼農

相關文章