【iOS】命名规范

1. 前言:

命名规则对于维护代码来说是非常重要的,Objective-C方法名往往很长,不过这也有好处,可以更清晰地理解和直观理解方法,甚至无须过多的注释;

1.基本原则

1.0:代码清晰

又清晰又简洁的代码当然是最好的了,但简洁不如清晰重要。总的讲不要使用单词的简写,除了非常常用的简写以外,尽量使用单词全称。API的名称不要有歧义,一看你的API就知道是以什么方式做了什么事情,不要让人有疑问!

1.1:一致性

代码保持一致,例如:创建UI相关的方法,可以使用统一的方法命名,所见即所得,见表知其意,这样,既保证了代码的一致性,也可以方便我们后续维护和管理,也利于团队代码风格的一致,协调!

2.类命名

2.1:命名规范

小驼峰命名法:第一个单字以小写字母开始;第二个单字的首字母大写,如:testClass
大驼峰命名法:每一个单字的首字母都采用大写字母,如:
TestClass
类命名:
首字母大写,之后每个单词首字母都大写
使用能够反映类功能的名词短语
文件和类同名
举例:BaseClient .h、ImageStore .h

特殊类命名
如果是视图控制器的子类应添加后缀“ViewController”或者“Controller”
如果是视图的子类应添加后缀“View”
如果是按钮的子类应添加后缀“Button”
等……
举例:SettingsViewController、NavigationView

分类(类别)命名
与类命名相同,此外需添加要扩展的类名和“+”
举例:NSString+URLEncoding

协议(委托)命名
与类命名相同,此外需添加“Delegate”后缀
举例:ReplyViewDelegate

方法命名
首字母小写,之后每个单词首字母都大写
方法名使用动词短语
举例:- (void)setPostValue:(int)value

方法参数命名
首字母小写,之后每个单词首字母都大写
具有足够的说明性
不需要添加类型前缀
举例:- (void)sendUserInfo:(NSDictionary *)userInfo

常量
常量(宏定义,局部常量等)使用小写k开头的驼峰法
举例:kInvalidHandle , kWritePerm

枚举类型命名首字母大写,之后每个单词首字母都大写,最后加“s”
枚举变量使用枚举类型去掉“s”作为前缀,每个单词首字母大写,中间不允许加下划线
举例:typedef enum UIControlEvents{
UIControlEventTouchDown,
UIControlEventTouchUpInside
}UIControlEvents;

分组命名
使用英文,首字母大写,之后每个单词首字母都大写
每个分组使用模块的名字
使用的开源库统一放在“Library”分组下
使用的公共组件统一放在“Common”分组下
视图控制器及AppDelegate统一放在“Controllers”分组下

2.2:类注释规范

一.类的声明:

/**  类信息。此注释用在类声明的开头。
@class
@abstract 这里可以写关于这个类的一些描述。
*/

示例1:
/**  类信息。此注释用在类声明的开头。
@TestClass
@这是一个测试类
*/
@interface TestClass :UIView
@end

二:变量的声明
/**
@property  property的相关注释。
@abstract 这里可以写关于这个Property的一些基本描述。
*/

示例2:
/**
* name:这是一个名字;
 */
@property (nonatomic,copy) NSString * name;

三:方法的声明

/**
@method  函数(方法)的相关注释。
@abstract 这里可以写一些关于这个方法的一些简要描述
@discussion 这里可以具体写写这个方法如何使用,注意点之类的。
如果你是设计一个抽象类或者一个共通类给给其他类继承的话,建议在这里具体描述一下怎样使用这个方法。
@param text 文字(这里把这个方法需要的参数列出来)
@param error 错误参照
@result 返回结果
*/

示例3:
/**
*  这是个请求数据方法;
*   result : (NSObject*)  数据返回结果;
* block :( doBlock)block 代码块,返回结果需要完成的事;
*/
-(void)doRequestResult:(NSObject*)result  andSuccessBlock:(doBlock)block ;

2.3:书写规范

 文件都包含文件头,要说明文件名、作者、创建时间、变更记录
多人协作完成项目时,public接口的每个方法都应该添加关于函数,参数,返回值以及副作用的注释
当if语句的判断条件复杂时,需要用注释说明判断内容
接口类(继承于BaseController)的头文件每个方法前都应该注明方法的作用

3.文件组织结构

3.1:类文件组织

iOS工程文件结构分物理结构和逻辑结构,建议逻辑结构和物理结构保持一致,以便方便有效地管理类文件。
类文件组织要遵循以下两大原则:
基于MVC设计模式原则,至少要保证controller与数据处理,网络请求相对独立
基于功能模块原则,功能模块分包括数据/网络处理,UI前端界面两部分,数据/网络处理应该在数据/网络处理的框架下,
而UI前端界面比如用户中心,消息中心,它们的专有的controller,view等应该在属于文件夹。
还会遇到一些公共的view,可以开辟出公共的文件夹来管理。
在实际中使用中,项目实际负责人可以结合项目特点灵活使用,
但基本的原则一定要保持,保持良好的类文件组织结构,对团队有益无害。

3.2:图片资源文件组织


图片资源文件,强烈建议采用Images.xcassets管理,
尽量少用自己创建的文件夹管理。
使用Images.xcassets的优势很多,具体可以查阅读相关文献资料,这里只从工程管理上说一点,在Images.xcassets中添加图片资源,
不会对project文件造成改变,而直接在文件夹里添加图片文件,每次都会对project文件造成改变,
因此使用Images.xcassets管理图片资源可以减少project冲突的次数

3.3:类代码组织原则

一个原则:
1.析构函数-
(void)dealloc最好放到类最上面,第一眼就可以看到这个方法,
可以方便看到是否remove了一些操作,对内存的合理释放等。
2.controller,view的生命周期函数放到最上面

3.自己实现的方法在下面,相同/相近功能的方法采用#pragma
mark -来标记,以便查看。

4. iOS代码规范

4.1:团队规范

说明:一个好的团队,理所当然有其严格的代码规范,好的代码不仅可以提高团队的开放效率,也更利于团队项目的后期维护,统一的代码风格,也是团队的核心,所以规范代码很有必要!
**
1 删除多余的空行 
 所有方法与方法之间空1行 
 所有代码块之间空1行

2 删除多余的注释 
 删除注释掉的代码 
 删除没有意义的注释

3 删除多余的方法 
 如果方法没有使用到,请删除它   
 如果方法没有执行任何业务逻辑,请删除它或者给出一定注释

4 删除未被使用的资源文件

5 添加必要的注释 
 所有.h 文件中的property 需要给出注释 
 所有自定义的方法需要给出注释   
 比较大的代码块需要给出注释 
 所有代码中出现的阿拉伯数字需要给出注释     
 程序中出现加密/解密 逻辑的操作地方,需要给出注释说明过程(无论是系统还是自定义)

6 整体代码风格需要统一 
 代码后面的”{“
 不需要单独占用一行     
 逻辑运算符 与 代码之前空一格 
 “#pragma mark -” 与下面的代码之前不要空行 
 遵循一般性的代码规范

4.2 iOS通用规范

1 下面所有规则对第三方类库无约束        
* 所有类、方法、属性等命名,做到见名知意,采用驼峰式命名规则* 根据资源类型或者所属业务逻辑对项目资源进行分组,使得整个项目结构清晰明了 
* 整个项目保持一种代码书写风格(这个风格由团队根据自己编码习惯来定),让你的代码变的优雅!
2. 命名规范   
* 所有类名称以项目工程开头命名,:“QMX”、“SX”、“CS”,”PF”等···; 
* 针对不同视图控制器,在末尾添加后缀,   
* UIViewController  后缀添加“ViewController” 
* UIView 后缀添加“View”     
* UIButton 后缀添加“Button" 
* UILabel 后缀添加“Label"
3. 单页代码最好控制在800行以内,每个方法最好不要超过100行,过多建议对代码进行重构
4. 相同的逻辑方法定义避免在多个地方出现,尽量将公用的类、方法抽取出来
5. 删除未被使用的代码,不要大片注释未被使用的代码,确定代码不会使用,请及时删除
6. 对其他项目中copy过来的代码,根据具体需要更新代码风格,及时删除未被使用的代码
7. 项目中所有Group或者文件名称(图片名字等),不要使用汉字命名,尽量使用英文命名,国内特有名词可以使用拼音。
8. 项目中所有Group都需要在项目目录中存在一个真实的目录,Group中的文件与真实目录中文件一一对应。
9. 请在项目中写必要代码的注释
10. 请多使用 #pragma
mark - Mark Name 对方法进行分组 

5.版权声明

该规范为iOS开发人员共同代码规范,共同维护开发,
如有更好的建议,欢迎在此基础上进行修改并在版本历史记录中添加修改内容,谢谢
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 202,529评论 5 475
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,015评论 2 379
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 149,409评论 0 335
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,385评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,387评论 5 364
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,466评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,880评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,528评论 0 256
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,727评论 1 295
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,528评论 2 319
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,602评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,302评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,873评论 3 306
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,890评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,132评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,777评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,310评论 2 342

推荐阅读更多精彩内容

  • 小驼峰命名法(CamelCase):第一个单词小写字母开头,其他单词首字母大写;大驼峰命名法(PascalCase...
    Paco_Ke阅读 673评论 2 0
  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,361评论 25 707
  • 1. Java基础部分 基础部分的顺序:基本语法,类相关的语法,内部类的语法,继承相关的语法,异常的语法,线程的语...
    子非鱼_t_阅读 31,556评论 18 399
  • 我相信有人一生 只碰过两片樱唇 却不相信谁能一生 只幻想一个女人 光怪的掌纹 裙下的游魂 装醉假寐也都骗不过风尘 ...
    段童阅读 494评论 0 1
  • “……舅妈好。你,怎么这么快就接电话了?”“我正在玩手机,所以就自动接通了。”“哦哦。”“说吧,有什么事求我。”“...
    珉二少阅读 635评论 8 3