【移動應(yīng)用開發(fā)技術(shù)】iOS項目的開發(fā)命名規(guī)范教程

前言遵守規(guī)范也是讓代碼更清晰明了，易讀，易用，易維護，可以更好的適應(yīng)團隊開發(fā)。自己看著也是賞心悅目，何樂而不為呢。下面話不多說了，來一起看看詳細的介紹吧。一、關(guān)于本文檔

1、本文檔的書寫目的

《iOS項目的命名規(guī)范》的書寫目的，在于讓后續(xù)參加到該項目的iOS開發(fā)人員通過閱讀該文檔，了解在當前iOS項目的代碼中的命名要求并嚴格按照本文檔執(zhí)行，以便保證代碼的更好閱讀與維護。2、本文檔的使用范圍

《iOS項目的命名規(guī)范》在iOS項目中被強制要求執(zhí)行。將本文中的WSF或者wsf替換成代表項目的前綴（請用三個大寫字母），即可用于其他iOS項目。3、本文檔的更新負責人

《iOS項目的命名規(guī)范》由本ID和同事共同協(xié)商討論制定，由本ID負責編輯、修改和后續(xù)的版本更新。二、目錄結(jié)構(gòu)三、新建【業(yè)務(wù)模塊文件夾】

1、文件夾的名稱需要體現(xiàn)該模塊的功能概括。

比如：支付系統(tǒng)、訂單2、二級文件夾根據(jù)編程設(shè)計模式分類命名，需要從下面詞語中取詞：

ViewModel、Model、View、ViewController、其他四、新建【子類】

1、類名

（1）遵循大駝峰命名法。

（2）WSF+模塊概括名+功能分區(qū)名+父類的慣用后綴。比如：WSFOrderListVC

（3）為了整個項目代碼的整潔與統(tǒng)一，建議使用List、Detail、Message、TView、Cell、VC、TVC、VM等字樣。

（4）模塊概括名一定要是統(tǒng)一的、明確的、唯一的代表模塊名稱。

（5）父類的慣用后綴的意思是：如果要從其他框架繼承子類，那么必須遵循其命名慣例。比如，繼承UIView的子類名稱必須以View結(jié)尾。2、屬性名

（1）遵循小駝峰命名法、避免縮寫。

（2）后綴體現(xiàn)屬性的數(shù)據(jù)類型。比如：orderPriceLabel、orderLimitsArray。

（3）使用長的、描述性的命名方向。比如settingButton而不是setBtn。

（4）要求NSString*nameString;而不是NSString*nameString;或者NSString*nameString;。3、屬性定義

（1）定義屬性的參數(shù)順序排序：原子性、讀寫、內(nèi)存管理。比如：@property(nonatomic,readwrite,copy)NSString*nameString;

（2）BOOL類型的屬性，需要為其getter方法帶is前綴。getter方法放在內(nèi)存管理限定符前面，比如：@property(nonatomic,readonly,getter=isEditable,assign)BOOLeditable;4、實例變量名

（3）下劃線開頭

（2）遵循小駝峰命名法、避免縮寫。

（3）后綴體現(xiàn)屬性的數(shù)據(jù)類型。比如：_orderPriceLabel、_orderLimitsArray。5、公有方法名

（1）遵循小駝峰命名法、避免縮寫。

（2）不要使用“and”這個詞，它不應(yīng)該用來闡明有多個參數(shù)。6、私有方法名

（1）遵循小駝峰命名法、避免縮寫。

（2）直接父類是Cocoa框架：p_開頭。

（3）直接父類是其他框架：以自己一貫的前綴（小寫）+下劃線開頭或者wsf_。比如：abc_、wsf_。7、純C函數(shù)

（1）遵循小駝峰命名法、避免縮寫。

（2）加上WSF為前綴。8、全局變量

.h文件

.m文件

（1）遵循大駝峰命名法、避免縮寫。9、枚舉名

（1）遵循大駝峰命名法、避免縮寫。

（2）使用OC的枚舉方式。

（3）枚舉對象名：WSF+枚舉范圍概括名+Type。比如：WSFAlipayResultCodeType

（4）枚舉種類名：WSF+枚舉范圍概括名+Type_某種情況名。比如：WSFAlipayResultCodeType_success。10、協(xié)議名

（1）遵循大駝峰命名法、避免縮寫。

（2）代理協(xié)議：類名+Delegate。比如：WSFOrderListChangedDelegate。

（3）數(shù)據(jù)源協(xié)議：類名+DataSource。比如：WSFOrderListDataSource。

（4）普通協(xié)議：類名+Protocol。比如：WSFOrderListVCProtocol。五、新建【分類】

1、分類名

（1）類名+標識前綴+擴展標識。

（2）遵循大駝峰命名法、避免縮寫。

（3）WSF或者自己一貫使用前綴（大寫）+下劃線為前綴。比如：NSString(WSF_HTTPManager)、NSString（ABC_HTTPManager）。2、方法名

（1）遵循小駝峰命名法、避免縮寫。

（2）wsf或者自己一貫使用前綴（小寫）+下劃線為前綴。比如：-(void)wsf_urlEncodedString;、-(void)abc_urlEncodedString;六、新建【協(xié)議】

1、協(xié)議名

（1）遵循大駝峰命名法、避免縮寫。

2、方法名

（1）遵循小駝峰命名法、避免縮寫。

（2）如果是代理協(xié)議，以發(fā)送代理的對象類名作為代理方法名的開始（去掉類名的前綴，并且遵循小駝峰命名法）。七、新建【第三方庫的封裝】

（1）手動管理：比如使用MJRefresh框架，需要將它的類名全部加前綴以避免命名空間沖突。比如：命名為WSFMJRefresh。

（2）pod管理：不需要特殊處理。八、新建【常量】

1、私有常量

.m文件

2、公開常量

.h文件

.m文件

說明：

（1）遵循小駝峰命名法、避免縮寫。

（2）在聲明公開常量時，也可以使用FOUNDATION_EXPORT替換e