雄牛iOS开发代码规范

1.图片全部放到 Assets.xcassets

2.类文件夹以项目首字母缩写大写开头,通用的东西以公司缩写开头

3.创建类时加上公司特有的类前缀

NS 是Foundation中的类前缀 NS 是Next Step 这家公司的简称
UI 对应是UIKit
BF 对应的是雄牛金融


比如创建一个图片浏览器的类

错误示例
PhotoBrowser
***************
好的习惯
BFPhotoBrowser

4.保持良好的可阅读性,代码一行尽量不超过120个字符,对于多参数方法尽量以冒号为基准,进行对齐

错误示范:
 - (void)addChildVC:(UIViewController *)childVC titile:(NSString *)title     normalImage:(NSString *)image selectdImage:(NSString *)selectedImage
{//相关操作
}

- (void)addChildVC:(UIViewController *)childVC  titile:(NSString *)title
             normalImage:(NSString *)image
    selectdImage:(NSString *)selectedImage

好的习惯:
- (void)addChildVC:(UIViewController *)childVC
          titile:(NSString *)title
     normalImage:(NSString *)image
    selectdImage:(NSString *)selectedImage
{//相关操作
}

5..正确的宏定义和常量的命名规范

错误示范:
#define baseUrl @"ommo.com"
好的习惯:
#define BASE_URL @"ommo.com"

常量的命名: 常量以小写字母k开头,后续首字母大写

错误示范:
 const NSString *TCPPort = @"80";
好的习惯:
 const NSString *kTCPPort = @"80";

6.关于 == 相等的判断

书写顺序

错误示范:
 if (HTTPStatusCode == 200){
    }
好的习惯:可以避免变成赋值操作
 if (200 == HTTPStatusCode){
    }

关于布尔值

错误示例:
Bool isAdult;
if (age > 18){
  isAdult = YES;
}  else {
  isAdult = NO;
}
//
好的习惯
Bool isAdult;
isAdult = age > 18; 

7.正确的使用 空格 让代码变的更加优美 拒绝拥挤的人生

方法+,-后,与()之间有1个空格

错误示范:
-(void)marryMe
{ }
好的习惯:
- (void)marryMe
{  }

运算符号间要留有合适的间隔

错误示范:
sum=value1+value2; 
UILable*lbl=[[UILable alloc]init] ; //疯掉了
好的习惯:
sum = value1 + value2;//瞬间 高大上
UILable *lbl = [[UILable alloc] init] ;

字典构造时的注意点 : 前后要留有一个空格

错误示范:
 NSDictionary *attributs = @{                        
    NSForegroundColorAttributeName:[UIColor orangeColor],
    NSFontAttributeName:[UIFont systemFontOfSize:12]
    };
正确示例:
  NSDictionary *attributs = @{                        
    NSForegroundColorAttributeName : [UIColor orangeColor],
    NSFontAttributeName : [UIFont systemFontOfSize:12]
    };

8. .h 文件中用 @class .m文件中用#import 避免重复导入

9.写delegate的时候类型应该为weak弱引用,以避免循环引用

错误示范:
@property (nonatomic, strong) id <UITableViewDataSource> dataSource;

正确操作:
@property (nonatomic, weak) id <UITableViewDataSource> dataSource;

10.建议使用“#pragma mark”,方便阅读代码

#pragma mark- dataSource
- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section
{
    return 6;
}
- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath
{//相关操作
}

#pragma mark- delegate
- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath
{//相关操作
}

11.实例变量声明时变量名前面加下划线“_”,局部变量不用加

错误示范:
@implementation ViewController
{
    UIButton *authCodeBtn;
}
- (void)viewDidLoad {
    [super viewDidLoad];
    UIButton *_loginBtn = [[UIButton alloc] init];
}

好的习惯:
@implementation ViewController
{
    UIButton *_authCodeBtn;
}
- (void)viewDidLoad {
    [super viewDidLoad];
    UIButton *loginBtn = [[UIButton alloc] init];
}


12.建议使用 NS_ENUMNS_OPTIONS 宏来定义枚举类型

错误示范:
typedef enum{

    UIButtonTypeInfoLight,
    UIButtonTypeInfoDark,
    UIButtonTypeContactAdd

} UIButtonType;

好的习惯:
typedef NS_ENUM(NSInteger, UIButtonType) {

    UIButtonTypeInfoLight,
    UIButtonTypeInfoDark,
    UIButtonTypeContactAdd

};

13.控件声明时要用 weak

错误示范:
@property (nonatomic,strong) UILabel *lbl;

正确示例:
@property (nonatomic,weak) UILabel *lbl;

在创建时
UILable *temLbl = [[UILable alloc] init]; //不这样做会因为引用计数 为0 被释放掉
self.lbl = temLbl;

14.通知的命名规范

通知命名规则: [触发通知的类名] + [Did | Will] + [动作] + Notification
错误示例:
UIKIT_EXTERN NSString *const textFieldTextBeginEditingNotification;
UIKIT_EXTERN NSString *const textFieldTextEndEditingNotification;
正确操作:
UIKIT_EXTERN NSString *const UITextFieldTextDidBeginEditingNotification;
UIKIT_EXTERN NSString *const UITextFieldTextDidEndEditingNotification;

15.正确的 if...else...

a.书写规范

错误示例:
if(){
//do somthing
} 
else {
//do somthing
}
正确的方式:
if(){
//do somthing
} else {
//do somthing
}

b.不合理的嵌套

错误示例:
if(userName.length){
     if (passWord.length) {
            //可以登录
        }
}
好的习惯:
if(!userName.length){ return; };
if(!passWord.length){ return; };

16.NSString、NSDictionary、NSArray和NSNumber的字面值应该在创建这些类的不可变实例时被使用。请特别注意nil值不能传入NSArray和NSDictionary字面值,因为这样会导致crash

错误示例:
NSArray *names = [NSArray arrayWithObjects:@"Rose",@"Jack",@"Alex", @"Steve", nil];  
NSDictionary *productManagers = [NSDictionary dictionaryWithObjectsAndKeys: @"Kate", @"iPhone": @"Kamal", @"iPad":@"Bill", nil];  
NSNumber *shouldScroll = [NSNumber numberWithBool:YES];  
NSNumber *buildingStreetNumber = [NSNumber numberWithInteger:100];  

正确方式:
NSArray *names = @[@"Rose",@"Jack",@"Alex", @"Steve"];  
NSDictionary *productManagers = @{ @"Kate" : iPhone" , @"Kamal" : @"iPad"};  
NSNumber *shouldScroll = @YES;  
NSNumber *buildingStreetNumber = @100; 

17.异常处理命名规则

[Prefix] + [UniquePartOfName] + Exception

错误示例:
FontUnavailable
****************
正确示例:
UIFontUnavailableException

18.对一些相同的东西避免写死,特别是控件的frame 不便于修改

比如有两个控件 左对齐

错误示例:
 UITextField *phoneTf = [[UITextField alloc] initWithFrame:CGRectMake(10, 0, 100, 40)];
 [self.view addSubview:phoneTf];
 UITextField *passwordTf = [[UITextField alloc] initWithFrame:CGRectMake(10, 110, 100, 40)];
 [self.view addSubview:passwordTf];
//
正确的方式:
 CGFloat margin = 10;
 CGFloat width = 100;
 CGFloat height = 40;
 UITextField *phoneTf = [[UITextField alloc] initWithFrame:CGRectMake(margin, 0, width, height)];
 [self.view addSubview:phoneTf];
 UITextField *passwordTf = [[UITextField alloc] initWithFrame:CGRectMake(margin, CGRectGetMaxY(phoneTf.frame) + margin, width, height)];
 [self.view addSubview:passwordTf];    

19.让方法的命名像一句话,即见名知意

错误示范:

- (void)chooseCard:(NSUInteger)index

好的习惯:

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

推荐阅读更多精彩内容