本文参考Apple & Google Objective-C编码规范，根据个人的编码习惯，总结出一些通用的编码规则。

代码示例

头文件示例代码

下面是用Objective-C语言编写的规范的头文件示例代码。

////  BTFoo.h//  CodingGuidelines////  Created by Tracy E on 12-8-13.//  Copyright (c) 2012年 ChinaMWorld Inc. All rights reserved.//#import 
       
        /** A sample class demonstrating good Objective-C style. All interfaces, categories, and protocols (read: all top-level declarations in a header) MUST be commented. Comments must alse be adjacent to the object they're documenting. */@protocol BTFooDelegate;@interface BTFoo : NSObject{  @private    NSString *_bar;    CGFloat _price;      @public    NSString *_name;    id
        
          _delegate;}@property (nonatomic, copy) NSString *name;                 //the name of Foo. default is nil.@property (nonatomic, assign) id
         
           delegate;   //weak reference. default is nil./** initializer. |string| will be copied and assigned to |_name|. @param string The foo name. @return an autorelease instance of BTFoo. */- (id)initWithString:(NSString *)string;/** Designated initailizer. initialize a new BTFoo object. @param name The model name. @param number The model number. @param price The model price. @return a newly initialized object. */- (id)initFooWithModelName:(NSString *)name               modelNumber:(NSUInteger)number                modelPrice:(CGFloat)price;/** Dosomething... @param name The model name. @param number The model number. @param price The model price. */- (void)doName:(NSString *)name    modelNumber:(NSUInteger)number    modelPrice:(CGFloat)price;//Gets and Sets |_bar|.- (NSString *)bar;- (void)setBar:(NSString *)bar;@end
         
        
       

 

源文件示例代码

下面是用Objective-C语言编写的规范的源文件示例代码。

////  BTFoo.m//  CodingGuidelines////  Created by Tracy E on 12-8-13.//  Copyright (c) 2012年 ChinaMWorld Inc. All rights reserved.//#import "BTFoo.h"@interface BTFoo (PrivateMethods)+ (id)fooWithString:(NSString *)string;@end@implementation BTFoo@synthesize name = _name;@synthesize delegate = _delegate;- (void)dealloc{    [_bar release];    [_name release];        [super dealloc];}- (id)initWithString:(NSString *)string{    self = [super init];    if (self) {        _name = [string copy];        _bar = [[NSString alloc] initWithFormat:@"bar"];    }    return self;}- (id)initFooWithModelName:(NSString *)name               modelNumber:(NSUInteger)number                modelPrice:(CGFloat)price{    self = [BTFoo fooWithString:name];    if (self) {        _price = price;    }    return self;    }- (void)doName:(NSString *)name    modelNumber:(NSUInteger)number    modelPrice:(CGFloat)price{    }- (NSString *)bar{    return _bar;}- (void)setBar:(NSString *)bar{    [_bar autorelease];    _bar = [bar copy];}#pragma mark BTFoo Private Methods+ (id)fooWithString:(NSString *)string{    return [[[BTFoo alloc] initWithString:string] autorelease];}- (void)doSomethingWith:(BTFoo *)theFoo                   rect:(CGRect)theRect               interval:(float)theInterval{    //...}- (void)short:(BTFoo *)theFoo    longKeyword:(CGRect)theRect    evenLongerKeyword:(float)theInterval{    //...}@end

 

间距与格式

程序中代码的排版，缩进，间隔等可以根据IDE的具体设置而决定，但最终都应该使代码的间距与格式统一，达到整齐美观的效果。

指针的位置

类型与“*”之间一个空格，“*”与变量名之间没有空格。

NSString *_text;

每行代码的长度

每行代码的长度不超过100个字符。每行代码的字符数可通过IDE进行设置。(设置：XCode —> Preferences —> Text Editing —> Page guide at column : 100)

方法的声明与定义

声明方法时，在 - 或 + 与返回类型之间应该留一个空格的间距。参数表的参数之间不要留间隔。

星号(*)前的空格是必须的。

- (id)initWithString:(NSString *)string;

如果参数过多，每个参数应各占一行。在有多行参数的情况下，每行参数前的冒号应对齐。

- (void)doSomethingWith:(BTFoo *)theFoo                   rect:(CGRect)theRect               interval:(float)theInterval{    //...}

当第一行的函数关键字比其后面行的关键字短时，后面的行应缩进四个空格。保证后续的关键字垂直对齐，而不应该采用冒号对齐的方式。

- (void)short:(BTFoo *)theFoo    longKeyword:(CGRect)theRect    evenLongerKeyword:(float)theInterval{    //...}

方法的调用

如果调用的方法没有超出一行（100字符长），则所有参数在同一行。

[item1 setTitle:@"提交" forState:UIControlStateNormal];

如果调用的方法过长，则每个参数占用一行，以冒号对其。

[button addTarget:self               action:@selector(buttonPressed:)     forControlEvents:UIControlEventTouchUpInside];

如果调用的方法过长，但方法名比参数名短，每个参数一行，缩进四个空格竖直对齐。

[self short:myFoo    longKeyword:rect    eventLongerKeyword:10];

@public 与 @private的使用

使用权限控制符@public 和@private 应缩进两个空格。

@interface MyClass : NSObject{  @private    NSInteger _count;  @public    NSString *_title;}@end

协议的使用

在类型标识符与协议的名之间不应该有空格。此协议使用的规范适用于类的声明、成员变量的声明以及方法的声明

@protocol MyClassDelegate;@interface MyClass : NSObject{  @private    id
       
         _delegate;}@property (nonatomic, assign) id
        
          delegate;
        
       

如果申明中包含多个protocal且超出一行时换行，缩进两个空格。

@interface CustomViewController : UIViewController
       
        {}
       

@property,@synthesize,@dynamic的使用

@property与左括号之间留一个空格。

@property和@synthesize的缩进级别与@interface或者@implementation的缩进级别相同。

@property的声明语句应该紧跟在类的成员变量声明语句块的后面。

@synthesize的实现语句应该紧跟在@implementation语句之后。

@interface BTAppDelegate : UIResponder 
       
        @property (strong, nonatomic) UIWindow *window;@end@implementation BTAppDelegate@synthesize window = _window;
       

命名规范

文件的命名

文件的名字应该反映其中包含的类名字，也应该遵循项目的风格习惯。

文件扩展命的使用规范如下：

.h	C/C++/Objective-C头文件
.m	Objective-C源文件
.mm	Objective-C++源文件
.cc	纯C++源文件
.c	C源文件

类的命名

类名应该用大写开头的驼峰命名法。

MyTableView、HomeViewController

在应用程序级别的代码中，尽量不要使用带前缀的类名。每个类都有相同的前缀不能提高可读性。如果是编写多个应用程序间的共用代码，那么需要为类名加上前缀。

Category的命名

Category的命名应该包含2-3个字符的前缀，用于说明Category是属于具体的某个工程的。

当声明一个Category时，Category的左括号与类名之间应该留一个空格的间隔。

例如要实现NSString的一个Category，用于实现解析功能。Category的文件名应该命名为NSString+GTMParsing.h，而Category的名字为GTMStringParsingAdditions，Category的名字与文件名不一致的原因是，在NSString+GTMParsing.h的文件中，可以声明多个用于解析功能的NSString类的Category。

Objective-C方法命名

1.方法应使用小写开头的驼峰法命名，每个参数都应该小写开头。

2.方法名应该尽可能读起来像一句话，参数名就如同方法名的补充说明(比如convertPoing:fromRect: 或者 replaceCharactersInRange:withString: )。

3.方法明中要避免单词缩写。

- (void)setBGImage:(UIImage *)img;              //避免- (void)setBackgroundImage:(UIImage *)image;    //推荐

变量的命名

变量名应使用小写开头的驼峰法命名。

类成员变量名应该以一个下划线开始。

常量(预定义，枚举，局部常量等)使用小写k开头的驼峰法。例如：

localVariable;            //局部变量 _instanceVariable;    //成员变量 kConstant;                //常量

注释

文件的注释

每个文件的开头都应该包含以下的注释。

1.文件名。

2.项目名称。

3.文件的创建者。

4.创建日期。

5.版权说明。

6.必要时还应包含许可声明。（如：Apache 2.0, BSD, LGPL, GPL）

声明的注释

对每个接口，类别，协议进行声明时，都应该有用于解释其功能或者如何使用的注释。

每个方法/函数声明时，都应该有用于解释其功能，参数值，返回值的注释，必要时还应该说明方法/函数的使用注意事项。

当类的成员变量可用于多线程访问时，应该对其使用做出详细的说明和解释。

//A delegate for NSApplication to handle notifications about app//launch and shut down. Owned by the main app controller.@interface AyAppDelegate : NSObject{} @end

实现的注释

在为接口，类别，协议，方法/函数等的实现写注释时，应该使用竖线引用变量，函数名或者其他符号。

//Sometimes we need |count| to be less than zero.//Remember to call |StringWithSpaces("foo bar baz")|

属性的类型

应该严格的控制属性的类型（readonly, copy, retain, assign）

不允许外部修改的属性，使用readonly；

NSString类型使用copy而不是retain；

代理delegate使用assign，禁止使用retain。

注意事项

成员变量访问权限

成员变量应该尽可能地定义为@private。

重写指定初始化方法

当对一个类进行子类化时，一定要重写父类的指定初始化方法。如果没有正确重写父类的指定初始化方法，子类的初始化方法可能不会被调用，这会导致很多微妙而难以预测的错误。

初始化

没有必要在类的初始化方法中将成员变量的初始值设置为0或者nil。

//都是多余的     BOOL editable = NO;        NSInteger currentIndex = 0;      NSString *title = nil;

BOOL的使用

1.当将一个整型赋值给BOOL类型时应该特别注意，因为BOOL的类型为unsigned char。

2.不应该将BOOL类型的变量直接与YES进行比较

if(editable){
     /*推荐*/ }   if(editable == YES){
     /*不推荐*/}

 

作者：Tracy E

出处：

本文版权归作者和博客园共有，欢迎转载，但转载请注明原文连接，否则保留追究法律责任的权利。