iOS 代码规范

时间 2019-11-20

标签 ios 代码规范栏目 iOS 繁體版

原文原文链接

1 目的

统一规范XCode编辑环境下Objective-C、swift的编码风格和标准swift

2 适用范围

适用于全部用Objective-C,swift语言开发的项目。数组

3 编码规范

3.1 文件

项目文件必须使用一个有意义的名字且前缀以PRJ_。例如：XCcode中下拉刷新的项目文件被命名为’PRJ_PullDownRefresh.xcodeproj’。
对于文件的目录要按以下结构建立：
- 创建Libraries文件夹，全部第三方库放入其中.(CocoaPods代替)
- 创建Constants.h头文件，全部的常量定义于其中。Constants.h文件放入Main文件组里面
- 项目中全部Group或者文件名称（图片名字等），不要使用汉字命名，尽可能使用英文命名，国内特有名词能够使用拼音。 
- 项目中全部Group都须要在项目目录中存在一个真实的目录，Group 中的文件与真实目录中文件一一对应。
为了避免影响阅读，一个类的代码行数尽可能不要超过300行;一个方法尽可能不要超过30行。有超过的在重构的时候想办法分解。

3.2 注释

注释能够采用’ /* */ ’和’ // ’两种注释符号，涉及到多行注释时，尽可能使用’ /* */ ’。
对于一行代码的注释可放在前一行及本行上，不容许放在下一行，更不容许在一行语句的中间加入注释。
单元文件的文件头注释说明应按以下格式：

//
//  ViewController.m
//  规范Demo
//
//  Created by KongYu on 16/5/18.
//  Copyright © 2016年 SLH. All rights reserved.
//

//  功能描述:
//  修改记录:
//      张三     2016-05-19  改变tableView的headerView的布局

没必要每行都加注释，在3~10行左右的段落作注释要好于每行都作注释，显而易见的代码不加注释。例如:

if (!returnValue) {//调用登陆过程失败无用的注释
  NSLog(@”登陆失败”);
}

方法的注释建议使用Xcode插件VVDocument使用，变量注释使用/** */ (使用的时候能够看到注释), 如：

/**
 *  <#Description#>
 *
 *  @param application   <#application description#>
 *  @param launchOptions <#launchOptions description#>
 *
 *  @return <#return value description#>
 */

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  // Override point for customization after application launch.
  return YES;
}

3.3 编码排版格式

代码的缩进应使用空格（SPACE），不能使用制表符（TAB），而且缩进以2个字符为单位。4个空格TAB
中括弧的每个括弧在源程序中要单独占一行。例如

for (int i = 0; i < 10; i++) {
}

空格的使用

- 关键字与其后的表达式之间要有空格，如： if (expr)或for (expo)
- 单目操做符不该与它们的操做数分开（如’!’和’^’等）。
- 除’ , ’外，其它双目操做符应与它们的操做数用空格隔开。例如

i=i+1;              //错误的写法，操做符两端没有空格
i = i + 1;            //正确的写法，
if(a>b)             //错误的写法，逻辑判断符号两端没有空格
if(a > b)            //正确的写法

.h中协议<>前面有一个空格。
.h中成员声明时，类型与变量之间有至少1个空格。*号靠近变量，不靠近类型。
@property后留1个空格，（）里面，逗号紧跟前一变量，与后一变量之间留1个空格。（）外面，先留1个空格，再声明属性。
方法的+，-后面与（）之间留1个空格。
返回类型与*之间留1个空格，方法参数中返回类型与*之间留1个空格。
在多参数方法中，每一个参数后面都有1个空格。

每行只能有一个语句

    //不正确写法
     NSUInteger objectIndex, stuffCount;
或
@synthesizeMyView, MyLabelView;


   //正确写法
   NSUIntegerobjectIndex;
   NSUIntegerstuffCount;
 或
  @synthesizeMyView;
  @synthesizeMyLabelView;

关于空行
- .h中的空行 --文件说明与头文件包含(#import)之间空1行
  - 头文件包含(#import)之间，若是须要分类区别，各种别之间空1行。
  - 头文件包含(#import)与@class之间空2行。
  - @interface与@class之间空1行。
  - 头文件{}里面，空1行开始声明对象成员，若是须要分类区别，各种别之间空1行。
  - 头文件{}外，空1行书写属性，若是须要分类区别，各种别之间空1行。
  - 属性下面空1行开始写方法，若是须要分类区别，各种别之间空1行。
  - 方法完成后，空1行@end。
  - 若是须要声明protocol，空2行接着写。一般protocol写在@end后面，可是声明在@interface以前。 -.m中的空行
  - 文件说明与头文件包含(#import)之间空1行
  - 头文件包含(#import)之间，若是须要分类区别，各种别之间空1行。
  - @implementation和@synthesize之间空1行, 若是须要分类区别，各种别之间空1行。
  - @synthesize与方法之间空1行。
  - 方法与方法之间空1行。
- 方法里面的空行
  - 变量声明后须要空1行，若是须要分类区别，各种别之间空1行。
  - 条件、循环，选择语句，整个语句结束，须要空1行。
  - 各功能快之间空1行。
  - 最后一个括弧以前不空行。
  - 注释与代码之间不空行。
  - 类中第个功能模块以 #pragma mark - 分隔，上空两行，下空一行。
  - 每行代码最多不得操做80个字。设置以下：Xcode => Preferences =>TextEditing => Page Guide at column /输入 80便可。

3.4 命名规范

保留字 Objective-c语言的保留字或关键词应所有使用小写字母，除下表中保留字外，private、protected、public、在类型说明中也做为保留字使用。还有nonatomanic,retain,readwrite,readonly等也有特殊的使用场合。

方法
- 方法的名称应所有使用有意义的单词组成，且以小写字母开头，多单词组合时，后面的单词首字母大写。例如：

- (void)getUserInformation……

设置类变量的内容的方法应使用set做为前缀，读取变量的内容的方法应使用get做为前缀。例如：

- (void)getUserName;
- (void)setUserName: (NSString *)userName;

方法中的参数：第一个参数名称要从函数名称上携带出来，第二个参数的首字母小写，多个单词组合时，后面单词首字母大写。参数有别名时，参数别名与参数名一致，但参数名前缀以_。参数别名与前一参数保留1个空格。参数无别名时，以有意义的字母命名。例如：

- (void)myFunctionWithSizeA:(CGSize)sizeA
                      sizeB:(CGSize)_sizeB;

当参数过长时，每一个参数占用一行，以冒号对齐

- (void)writeFisrtNumber:(NSString *)firstStr
            withNextNumber:(NSString *)nextStr
             withLastNumber:(NSString *)lastStr {
}

若是方法名比参数名短，每一个参数占用一行，至少缩进4个字符，且为垂直对齐（而非使用冒号对齐）

- (void)writeA:(NSString *)firstStr
        withBBBBBBBBBBB:(NSString *)nextStr
        withCCCCCC:(NSString *)lastStr {
    
}

变量
- 变量必须起有意义的名字，使其余组员能够很容易读懂变量所表明的意义，变量命名能够采用同义的英文命名，可以使用几个英文单词，第一个单词首字母小写，其余单词首字母大写。例如：

NSString *username;

对于一些特殊类型的变量，命名时要带上类型，如NSArray的变量命名为xxxArray，其余的如xxxDictionary，xxxSize等。这样就能够从名称上知道是什么类型的变量。千万不能将NSArray的变量命名为xxxDictionary. 如如果可变的变量加M, eg: xxxMArray。
对于要和interface builder关联的的输出口变量，命名时要后缀以特定的控件名.常见的：

UIViewController:VC          UIImage:Img　　              UIImageView:ImgView　　UIView:View　　
UILabel:Label                       UIButton:Btn　                 UINavigationBar:NBar　　UIToolBar:TBar　　
UISearchBar:SBar                UITextField:textField　    UITextView:TextView
 NSArray:Array　　     NSMutableArray:MArray         NSDictionary:Dict　　     NSMutableDictionary:Dict
NSString:Str　　       NSMutableString:MStr               NSSet:Set　　　　　        NSMutableSet:MSet

对于使用c语言形式声明的变量，一些特定类型可采用必定的简写：例如：

指针类型：P
结构体类型：Rec
数组类型：Arr
   Core Graphic：CG 等。

循环控制变量一般使用单一的字符如：i、j、k等。使用有意义的名字，如objectIndex也是能够的。
尽可能避免使用全局变量，若是必须使用全局变量则必须加前缀‘ Pub_’,同时应在变量名称中体现变量的类型。
私有实例变量前加一个下划线，如_myPrivateVarible。
枚举变量也要有相应的前缀来区分不一样的enum变量。好比苹果公司的一个enum。例如：

/* Drawing modes for text. */

enumCGTextDrawingMode {
  kCGTextFill,
  kCGTextStroke,
  kCGTextFillStroke,
  kCGTextInvisible,
  kCGTextFillClip,
  kCGTextStrokeClip,
  kCGTextFillStrokeClip,
  kCGTextClip
};

常量
- 避免在程序中直接出现常数，使用超过一次的应以宏定义的形式来替代。
- 常数的宏定义应与它实际使用时的类型相一致。如以3.0来定义浮点类型，用3表示整型。
- 常量的命名应当可以表达出它的用途，而且用大写字母表示。例如：

#define PI 3.1415926

宏变量以k开头.eg:

#define kLogin “login”

类
- 全部的类名，接口名(Protocol)均以大写字母开头，多单词组合时，后面的单词首字母大写。类，接口名必须是有意义的。
- 继承自UIView的类以View结尾。例如：

OperatorUsersInfomationView，LabelView等。

继承自ViewController的类以viewController结尾。例如：

HomePageViewController，LoginViewController等。其余类推。

全部保存数据的实体以Model结尾。例如：

UserModel，FriendModel

若是类声明中包含多个protocal，每一个protocal占用一行，缩进2个字符

@interfaceRootViewController : UITableViewController <
UITableViewDelegate,
UITableViewDataSource,
UITextFieldDelegate,
UITextViewDelegate
 
> {
……
}

4 修改规范

4.1 新增代码行

新增代码行的先后应有注释行说明。xcode

//修改人，修改时间，修改说明
新增代码行
//修改结束

4.2 删除代码行

删除代码向的先后用注释行说明app

//修改人，修改时间，修改说明
要删除的代码行(将要删除的语句进行注释)
//修改结束

4.3 修改代码行

修改代码行以注释旧代码行后再新增代码行的方式进行。ide

//修改人，修改时间，修改说明
//修改前代码行开始
//修改前代码行
//修改前代码行结束
//修改后代码行开始
修改后代码行
//修改结束