《IOS编码及注释规范》由会员分享，可在线阅读，更多相关《IOS编码及注释规范（10页珍藏版）》请在金锄头文库上搜索。
1、IOS开发编码及命名规范目录1、目的32、适用范围33、编码规范33.1、文件33.2、注释33.3、编码排版格式53.4、命名规范6、保留字6、方法7、变量7、常量8、类9图片命名93.5、修改规范9、新增代码行9、删除代码行10、修改代码行10、其他规范101、目的统一规范XCode编辑环境下Objective-C的编码风格和标准2、适用范围适用于所有用Objective-C语言开发的项目。3、编码规范3.1、文件1) 项目文件必须使用一个有意义的名字一般用bundleId最后一位如lender .xcodeproj。2) 公共文件统一命名为Public.h。任何文件的命名尽量不要以中文命
2、名。3) 对于文件的目录要按如下结构创建： -Document（文档所在路径） -Help（帮助文件所在路径） -图片等资源文件放在单独的目录与组(Group)中，如Images。 -所有的view放在单独的组(Group)中，如Custom View。 -所有的viewController放在单独的组中，如viewControllers。 -引用外部文件或者某个单独的功能时，放在单独的组中，例如：程序中使用了coverflow功能，引用openflow的文件时，将其全部文件放在openFlow这个组中。其view和viewcontroller等文件的组织不受上面所规定的影响。 4) bund
3、leId命名：公司的域名反过来最后一位是项目名称一般越短越好 举例：com.ppdai.*(com.ppdai.lender)3.2、注释1) 注释可以采用 /* */ 和 / 两种注释符号，涉及到多行注释时，尽量使用 /* */ 。2) 对于一行代码的注释可放在前一行及本行上，不允许放在下一行，更不允许在一行语句的中间加入注释。3) 单元文件的文件头注释说明应按如下格式： / 文件名/ 工程名/ Created by 创建者 on 日期./ Copyright 2010 xxx有限公司. All rights reserved./ 系统名称： / 功能描述：/ 修改记录：(仅记录功能修改)/
4、 张三 2012-02-02 创建该单元 / 小明 2010-03-02 增加本地点单功能。/4) 方法前面的注释遵循以下格式：如果某项没有，则以N/A表示 例如： /* 函数名称：-(BOOL)showFiveAndSixStairRoomCountByStatu 函数描述：显示特定状态下五楼和六楼的房间数 输入参数：(NSString *)statu：某状态。输出参数：(int *)roomCount ：该状态房间数量。 返回值：BOOL：操作是否成功。 */- (void)showFiveAndSixStairRoomCountByStatu:(NSString *)statu room
5、Count:(int *)_roomCount;或/* 函数名称：-(NSUInteger)showFiveAndSixStairRoomCount 函数描述：显示五楼六楼的房间数。 输入参数：N/A 输出参数：N/A 返回值：NSUInteger :房间数量。 */- (NSUInteger)showFiveAndSixStairRoomCount5) 不必每行都加注释，在310行左右的段落做注释要好于每行都做注释，显而易见的代码不加注释。例如：if (!returnValue) /调用登录过程失败 无用的注释 NSLog(”登录失败”);3.3、编码排版格式 1) 代码的缩进应使用空格（S
6、PACE），不能使用制表符（TAB），并且缩进以2个字符为单位。 2) 中括弧的每一个括弧在源程序中要单独占一行。 例如 /不正确用法 for (int i = 0; i 10 ; i+) /正确用法for (int i = 0; i b) /错误的写法，逻辑判断符号两端没有空格 if(a b) /正确的写法 d) .h中协议前面有一个空格。 e) .h中成员声明时，类型与变量之间有至少1个空格。*号靠近变量，不靠近类型。 f) property后留1个空格，（）里面，逗号紧跟前一变量，与后一变量之间留1个空格。（）外面，先留1个空格，再声明属性。 g) 方法的+，-后面与（）之间留1个空格。
7、 h) 返回类型与*之间留1个空格，方法参数中返回类型与*之间留1个空格。 i) 在多参数方法中，每个参数后面都有1个空格。 4) 每行只能有一个语句 例如 /不正确写法 NSUInteger objectIndex, stuffCount; 或 objectIndex = objectIndex + 10, stuffCount = stuffCount + 20; 或 synthesize MyView, MyLabelView; /正确写法 NSUInteger objectIndex;NSUInteger stuffCount;或objectIndex = objectIndex +
8、10;stuffCount = stuffCount + 20;或synthesize MyView;synthesize MyLabelView; 5) 关于空行 a) .h中的空行 、文件说明与头文件包含(#import)之间空1行 、头文件包含(#import)之间，如果需要分类区别，各类别之间空1行。 、头文件包含(#import)与class之间空2行。 、interface与class之间空1行。 、头文件里面，空1行开始声明对象成员，如果需要分类区别，各类别之间空1行。 、头文件外，空1行书写属性，如果需要分类区别，各类别之间空1行。 、属性下面空1行开始写方法，如果需要分类区别
9、，各类别之间空1行。 、方法完成后，空1行end。 、如果需要声明protocol，空2行接着写。通常protocol写在end后面，但是声明在interface之前。 b) .m中的空行 、文件说明与头文件包含(#import)之间空1行 、头文件包含(#import)之间，如果需要分类区别，各类别之间空1行。 、implementation和synthesize之间空1行, 如果需要分类区别，各类别之间空1行。 、synthesize与方法之间空1行。 、方法与方法之间空1行。 C) 方法里面的空行 、变量声明后需要空1行，如果需要分类区别，各类别之间空1行。 、条件、循环，选择语句，整个
10、语句结束，需要空1行。 、各功能快之间空1行。 、最后一个括弧之前不空行。 、注释与代码之间不空行。 、#pragma mark 与方法之间空1行。 d) 每行代码最多不得操作100个字。设置如下：Xcode = Preferences = TextEditing = Page Guide at column /输入 100即可。3.4、命名规范3.4.1、保留字Objective-c语言的保留字或关键词应全部使用小写字母，除下表中保留字外，private、protected、public、在类型说明中也作为保留字使用。还有nonatomanic,retain,readwrite,readon
11、ly等也有特殊的使用场合。_Bool_Complex_Imaginaryautobreakbycopybyrefcasecharconstcontinuedefaultdodoubleelseenumexternfloatforgotoifininlineinoutintlongonewayoutregisterrestrictreturnselfshortsignedsizeofstaticstructsuperswitchtypedefunionunsignedvoidvolatilewhile3.4.2、方法1) 方法的名称应全部使用有意义的单词组成，且以小写字母开头，多单词组合时，后面的单词首字母大写。例如： -(void)getUserInformation2) 设置类变量的内容的方法应使用set作为前缀，读取变量的内容的方法应使用get作为前缀。 例如： -(void)getUserName; -(void)setUserName:(NSString *)userName
