IOS 代码规范

一、命名规范

命名规则对于维护代码来说是非常重要的,。Objective-C方法名往往很长,不过这也有好处,让很多注释变得毫无意义。

1、驼峰法

 Objective-C社区的标准,驼峰法分小驼峰法和大驼峰法。小驼峰法:除第一个单词之外,其他单词首字母大写,一般用于变量命名。大驼峰法相比小驼峰法,大驼 峰法把第一个单词的首字母也大写了,一般用于对象命名。

2、基本原则

1) 清晰(可读性高)

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

2) 一致性

做某个事情代码通常都叫这个名字,比如tag、setStringValue,那么你也这么叫。你在不确定怎么起名字的时候,可以参考一些常用的名字:Method Arguments

3)禁止使用中文或拼音(英文不好?  有道一下啦)

3. 类命名

类名(不包括类别和协议名)应该用大写开头的大驼峰命名法。类名中应该包含一个或多个名词来说明这个类(或者类的对象)是做什么的。在应用级别的代码里,尽量不要使用带前缀的类名。每个类都有相同的前缀不能提高可读性。不过如果是编写多个应用间的共享代码,前缀就是可接受并推荐的做法了(型如 MWPhotoBrowser )。

4. 类别命名(Category)

类名+标识+扩展(UIImageView +HP+Web)

类别的方法应该都使用一个前缀(型如hp_myCategoryMethodOnAString ),以防止Objective-C代码在单名空间里冲突。如果代码本来就不考虑共享或在不同的地址空间(address-space),方法命名规则就没必要恪守了。

5. 方法命名 

方法使用小驼峰法命名, 一个规范的方法读起来应该像一句完整的话,读过之后便知函数

的作用。执行性的方法应该以动词开头,小写字母开头,返回性的方法应该以返回的内容

开头,但之前不要加get。

6. 变量命名 

1)变量名使用小驼峰法, 使变量名尽量可以推测其用途属性具有描述性。必须起有意义的名字,使其他组员可以很容易读懂变量所代表的意义,变量命名可以采用同义的英文命名,可使用几个英文单词。别一心想着少打几个字母,让你的代码可以迅速被理解更加重要。

2)对于一些特殊类型的变量,命名时要带上类型,如NSArray 的变量命名为xxxArray 或xxxList,其他的如xxxDictionary,xxxSize等。这样就可以从名称上知道是什么类型的变量。千万不能将NSArray的变量命名为xxxDictionary。

3)对于UI控件变量,命名时后缀要以特定的控件名。

如:@property (weak, nonatomic) IBOutlet UILabel *versionLabel;

4)控制器的后缀必须加ViewController, 名字过长的情况下也必须加上Controller作为后缀;

5) 普通View后缀必须加View,UITableViewCell和UICollectionViewCell后缀必须加Cell;

6)成员变量命名,尽量采用@property方式来申明变量,如果不用@property方式申明变量,则必须采用前缀下划线来申明变量

7. 常量命名

1)对于常量的命名最好在前面加上字母k作为标记. 如:

static const NSTimeInterval kAnimationDuration = 0.3;

2)定义作为NSDictionary或者Notification等的Key值字符串时加上const关键字, 以防止被修改,通知的name一定要以Notification作为后缀。如:

NSString *const UIApplicationDidEnterBackgroundNotification

3) 避免在程序中直接出现常数,使用超过一次的应以宏定义的形式来替代。

8. 枚举命名

枚举类型命名要加相关类名前缀并且枚举值命名要加枚举类型前缀.

typedef NS_ENUM(NSInteger, UIViewAnimationTransition) {

   UIViewAnimationTransitionNone,

    UIViewAnimationTransitionFlipFromLeft,

    UIViewAnimationTransitionFlipFromRight,

    UIViewAnimationTransitionCurlUp,

    UIViewAnimationTransitionCurlDown,

};

9. 图片资源文件命名 

原则:

1)采用单词全拼,或者大家公认无岐义的缩写(比如:nav,bg,btn等)

2)采用“模块+功能”命名法,模块分为公共模块、私有模块。公共模块主要包括统一的背

景,导航条,标签,公共的按钮背景,公共的默认图等等;私有模块主要根据app的业务

功能模块划分,比如用户中心,消息中心等

注:Assets.xcassets中文件夹必须分模块,命名必须小写,图片必须命名好之后再放入Assets.xcassets中。通常来说,Assets中至少包含common,tabbar,navigation这三个模块。

公共模块命名示例:

背景图采用以bg作后缀缀,按钮背景采用btn作后缀;

导航条背影图片:nav_bar_bg@2x.png

导航返回按钮:nav_back@2tx.png

标签item背景:tabbar_record_normal@2x.png,tabbar_record_selected@2x.png

通用cell占位图:common_cell_placeholder@2x.png

私有模块命名示例:

以用户中心图片资源为例说明:

用户中心头像默认图:mine_avatar_bg@2x.png

用户中心顶部默认背景图:mine_top_defaut_bg@2x.png

9. 目录命名

用英文命名时,首字母大写,可以用中文命名,但是禁止使用拼音命名。

二、编码排版格式

1、代码的缩进应使用空格(SPACE),不能使用制表符(TAB),并且缩进以2个 字符为单位。快捷方式:Command + A   —— > Control + I    

2、 中括弧的每一个括弧在源程序中要单独占一行。

3、 空格的使用      

a) 关键字与其后的表达式之间要有空格

b) 单目操作符不应与它们的操作数分开(如’!’和’^’等)。     

c) 除’ , ’外,其它双目操作符应与它们的操作数用空格隔开。

d) .h中协议<>前面有一个空格。      

e) .h中成员声明时,类型与变量之间有至少1个空格。*号靠近变量,不靠近类型。    

f) @property后留1个空格,()里面,逗号紧跟前一变量,与后一变量之间留1 个空格。()外面,先留1个空格,再声明属性。       

g) 方法的+,-后面与()之间留1个空格。       

h) 返回类型与*之间留1个空格,方法参数中返回类型与*之间留1个空格。      

i)  在多参数方法中,每个参数后面都有1个空格。

4、 每行只能有一个语句

5、关于空行

     a) .h中的空行       

1、文件说明与头文件包含(#import)之间空1行         

2、头文件包含(#import)之间,如果需要分类区别,各类别之间空1行。        

3、头文件包含(#import)与@class之间空2行。         

4、@interface与@class之间空1行。         

5、头文件{}里面,空1行开始声明对象成员,如果需要分类区别,各类别之间空1行。        

6、头文件{}外,空1行书写属性,如果需要分类区别,各类别之间空1行。         

7、属性下面空1行开始写方法,如果需要分类区别,各类别之间空1行。         

8、方法完成后,空1行@end。        

9、如果需要声明protocol,空2行接着写。通常protocol写在@end后面,但是声明在@interface之前。      

b) .m中的空行          

1、文件说明与头文件包含(#import)之间空1行        

2、头文件包含(#import)之间,如果需要分类区别,各类别之间空1行。         

3、@implementation和@synthesize之间空1行, 如果需要分类区别,各类别之间空1行。          

4、方法与方法之间空1行。     

c) 方法里面的空行          

1、变量声明后需要空1行,如果需要分类区别,各类别之间空1行。         

2、条件、循环,选择语句,整个语句结束,需要空1行。         

3、各功能快之间空1行。         

4、最后一个括弧之前不空行。         

5、注释与代码之间不空行。         

6、#pragma mark 与方法之间空1行。      

d) 每行代码最多不得操作100个字。设置如下:Xcode => Preferences => TextEditing   => Page Guide at column /输入 100即可。

6、注释

1、变量名、方法名等不足以说明实际意义的时候,必须要写注释;

2、类名不足以提现类的作用的时候,必须在类声明的上面添加注释,说明类的基本作用。

3、可能涉及到注释的地方主要包括:

类注释、方法注释、成员变量注释、枚举注释、宏定义注释、宏定义方法注释、逻辑注释、Protocol注释

4、推荐使用VVDocumenter

5、文件夹:所有新建的目录,在工程下必须存在实体目录;

6、单页面代码不得超过800行,单个方法不得超过50行。

3 、规定

1、 dealloc方法    规定:一个类的dealloc方法如果有必要存在,必须是.m中的最后一个方法,方便查找;

2、非特殊需要,不允许将UI控件的property直接创建到.h文件中;

3、当需要一定条件才执行某项操作时,最左边的应该是最重要的代码,不要将最重要的代码内嵌到if中。

如良好的风格是:

- (void) someMethod {

if(![someOther boolValue]) {

 return;}

//最重要的代码写在这里;

}

反面教材:

- (void) someMethod {

  if([someOther boolValue]) {

     //重要代码;}

}

4 、建议

1、尽量不使用for循环,可用forin或者enumerateObjectsUsingBlock进行遍历;

2、尽可能保证 .h文件的简洁性,可以不公开的API就不要公开了,写在实现文件中即可;

3、建议使用“#pragma mark”,方便阅读代码。有些由于数据等方面问题需要以后做处理的使用#pragma warnning”进行提醒;

4、if-else超过四层的时候,就要考虑重构,多层的if-else结构很难维护;

5、UIView的子类初始化的时候,不要进行任何的布局操作。布局操作应该在layoutSubviews里面做;需要重新布局的时候调用setNeedsLayout,而不要直接调用layoutSubviews。(一般代码创建的时候这样做);

6、推荐方法的第一个花括号直接跟在方法体后,而不是另起一行,这样可以减少代码行;

7、方法体中的第一行留空,最后一行不留空,这样一个方法就会比较清晰,但是如果该花括号里面又是一个if,for之类的带花括号的语句块,那么上述的第一行可以不留空。

同样,如果花括号内第一行是注释的话,第一行也可以不留空。注释也起到了分隔代码的作用,看起来比较清晰。

再者,如果花括号内只有一行代码,第一行可以不留空。du -k repos

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