> 最近重构项目组件/uff0c看到项目中存在一些命名和方法分块方面存在一些问题/uff0c结合平时经验和 [Apple官方代码规范](https://developer.apple.com/library/archive/documentation/Cocoa/Conceptual/CodingGuidelines/CodingGuidelines.html) 在此整理出 iOS 工程规范。提出第一个版本/uff0c如果后期觉得有不完善的地方/uff0c继续提出来不断完善/uff0c文档在此记录的目的就是为了大家的代码可读性较好/uff0c后来的人或者团队里面的其他人看到代码可以不会因为代码风格和可读性上面造成较大时间的开销。 软件的生命周期贯穿产品的开发/uff0c测试/uff0c生产/uff0c用户使用/uff0c版本升级和后期维护等过程/uff0c只有易读/uff0c易维护的软件代码才具有生命力。 ## 一些原则 1. 长的/uff0c描述性的方法和变量命名是好的。不要使用简写/uff0c除非是一些大家都知道的场景比如 VIP。不要使用 bgView/uff0c推荐使用 backgroundView 2. 见名知意。含义清楚/uff0c做好不加注释代码自我表述能力强。/uff08前提是代码足够规范/uff09 3. 不要过分追求技巧/uff0c降低代码可读性 4. 删除没必要的代码。比如我们新建一个控制器/uff0c里面会有一些不会用到的代码/uff0c或者注释起来的代码/uff0c如果这些代码不需要/uff0c那就删除它/uff0c留着偷懒吗/uff1f下次需要自己手写 5. 在方法内部不要重复计算某个值/uff0c适当的情况下可以将计算结果缓存起来 6. 尽量减少单例的使用。 7. 提供一个统一的数据管理入口/uff0c不管是 MVC、MVVM、MVP 模块内提供一个统一的数据管理入口会使得代码变得更容易管理和维护。 8. 除了 .m 文件中方法/uff0c其他的地方"{"不需要另起一行。 ```Objective-c - (void)getGooodsList { // ... } - (void)doHomework { if (self.hungry) { return; } if (self.thirsty) { return; } if (self.tired) { return; } papapa.then.over; } ``` ## 变量 1. 一个变量最好只有一个作用/uff0c切勿为了节省代码行数/uff0c觉得一个变量可以做多个用途。/uff08单一原则/uff09 2. 方法内部如果有局部变量/uff0c那么局部变量应该靠近在使用的地方/uff0c而不是全部在顶部声明全部的局部变量。 ## 运算符 1. 1元运算符和变量之间不需要空格。例如/uff1a++n 2. 2元运算符与变量之间需要空格隔开。例如/uff1a containerWidth = 0.3 * Screen_Width 3. 当有多个运算符的时候需要使用括号来明确正确的顺序/uff0c可读性较好。例如/uff1a 2 << (1 + 2 * 3 - 4) ## 条件表达式 1. 当有条件过多、过长的时候需要换行/uff0c为了代码看起来整齐些 ``` //good if (condition1() && condition2() && condition3() && condition4()) { // Do something } //bad if (condition1() && condition2() && condition3() && condition4(/uff09) { // Do something } ``` 2. 在一个代码块里面有个可能的情况时善于使用 `return` 来结束异常的情况。 ``` - (void)doHomework { if (self.hungry) { return; } if (self.thirsty) { return; } if (self.tired) { return; } papapa.then.over; } ``` 3. 每个分支的实现都必须使用 {} 包含。 ``` // bad if (self.hungry) self.eat() // good if (self.hungry) { self.eat() } ``` 4. 条件判断的时候应该是变量在左/uff0c条件在右。 if ( currentCursor == 2 ) { //... } 5. switch 语句后面的每个分支都需要用大括号括起来。 6. switch 语句后面的 default 分支必须存在/uff0c除非是在对枚举进行 switch。 ``` switch (menuType) { case menuTypeLeft: { // ... break; } case menuTypeRight: { // ... break; } case menuTypeTop: { // ... break; } case menuTypeBottom: { // ... break; } } ``` ## 类名 1. 大写驼峰式命名。每个单词首字母大写。比如「申请记录控制器」ApplyRecordsViewController 2. 每个类型的命名以该类型结尾。 - ViewController/uff1a使用 `ViewController` 结尾。例子/uff1aApplyRecordsViewController - View/uff1a使用 `View` 结尾。例子/uff1a分界线/uff1aboundaryView - NSArray/uff1a使用 `s` 结尾。比如商品分类数据源。categories - UITableViewCell/uff1a使用 `Cell` 结尾。比如 MyProfileCell - Protocol/uff1a使用 `Delegate` 或者 `Datasource` 结尾。比如 XQScanViewDelegate - Tool/uff1a工具类 - 代理类/uff1aDelegate - Service 类/uff1aService ## 类的注释 有时候我们需要为我们创建的类设置一些注释。我们可以在类的下面添加。 ## 枚举 枚举的命名和类的命名相近。 ``` typedef NS_ENUM(NSInteger, UIControlContentVerticalAlignment) { UIControlContentVerticalAlignmentCenter = 0, UIControlContentVerticalAlignmentTop = 1, UIControlContentVerticalAlignmentBottom = 2, UIControlContentVerticalAlignmentFill = 3, }; ``` ## 宏 1. 全部大写/uff0c单词与单词之间用 `_` 连接。 2. 以 `K` 开头。后面遵循大写驼峰命名。「不带参数」 ``` #define HOME_PAGE_DID_SCROLL @"com.xq.home.page.tableview.did.scroll" #define KHomePageDidScroll @"com.xq.home.page.tableview.did.scroll" ``` ## 属性 书写规则/uff0c基本上就是 `@property 之后空一格/uff0c括号/uff0c里面的 线程修饰词、内存修饰词、读写修饰词/uff0c空一格 类 对象名称` 根据不同的场景选择合适的修饰符。 ``` @property (nonatomic, strong) UITableView *tableView; @property (nonatomic, assign, readonly) BOOL loading; @property (nonatomic, weak) id<#delegate#> delegate; @property (nonatomic, copy) <#returnType#> (^<#Block#>)(<#parType#>); ``` ## 单例 单例适合全局管理状态或者事件的场景。一旦创建/uff0c对象的指针保存在静态区/uff0c单例对象在堆内存中分配的内存空间只有程序销毁的时候才会释放。基于这种特点/uff0c那么我们类似 UIApplication 对象/uff0c需要全局访问唯一一个对象的情况才适合单例/uff0c或者访问频次较高的情况。我们的功能模块的生命周期肯定小于 App 的生命周期/uff0c如果多个单例对象的话/uff0c势必 App 的开销会很大/uff0c糟糕的情况系统会杀死 App。如果觉得非要用单例比较好/uff0c那么注意需要在合适的场合 tearDown 掉。 单例的使用场景概括如下/uff1a - 控制资源的使用/uff0c通过线程同步来控制资源的并发访问。 - 控制实例的产生/uff0c以达到节约资源的目的。 - 控制数据的共享/uff0c在不建立直接关联的条件下/uff0c让多个不相关的进程或线程之间实现通信。 ```objective-c + (instancetype)sharedInstance { static dispatch_once_t onceToken; dispatch_once(&onceToken, ^{ //because has rewrited allocWithZone use NULL avoid endless loop lol. _sharedInstance = [[super allocWithZone:NULL] init]; }); return _sharedInstance; } + (id)allocWithZone:(struct _NSZone *)zone { return [TestNSObject sharedInstance]; } + (instancetype)alloc { return [TestNSObject sharedInstance]; } - (id)copy { return self; } - (id)mutableCopy { return self; } - (id)copyWithZone:(struct _NSZone *)zone { return self; } ``` ## 私有变量 推荐以 `_` 开头/uff0c写在 .m 文件中。例如 NSString * _somePrivateVariable ## 代理方法 1. 类的实例必须作为方法的参数之一。 2. 对于一些连续的状态的/uff0c可以加一些 will/uff08将要/uff09、did/uff08已经/uff09 3. 以类的名称开头 ```objective-c - (void)tableView:(UITableView *)tableView willDisplayCell:(UITableViewCell *)cell forRowAtIndexPath:(NSIndexPath *)indexPath; - (void)tableView:(UITableView *)tableView didEndDisplayingCell:(UITableViewCell *)cell forRowAtIndexPath:(NSIndexPath *)indexPath; ``` ## 方法 1. 方法与方法之间间隔一行 2. 大量的方法尽量要以组的形式放在一起/uff0c比如生命周期函数、公有方法、私有方法、setter && getter、代理方法.. 3. 方法最后面的括号需要另起一行。遵循 Apple 的规范 4. 对于其他场景的括号/uff0c括号不需要单独换行。比如 if 后面的括号。 5. 如果方法参数过多过长/uff0c建议多行书写。用冒号进行对齐。 6. 一个方法内的代码最好保持在50行以内/uff0c一般经验来看如果一个方法里面的代码行数过多/uff0c代码的阅读体验就很差/uff08别问为什么/uff0c做过重构代码行数很长的人都有类似的心情/uff09 7. 一个函数只做一个事情/uff0c做到单一原则。所有的类、方法设计好后就可以类似搭积木一样实现一个系统。 8. 对于有返回值的函数/uff0c且函数内有分支情况。确保每个分支都有返回值。 9. 函数如果有多个参数/uff0c外部传入的参数需要检验参数的非空、数据类型的合法性/uff0c参数错误做一些措施/uff1a立即返回、断言。 10. 多个函数如果有逻辑重复的代码/uff0c建议将重复的部分抽取出来/uff0c成为独立的函数进行调用 ```objective-c - (instancetype)init { self = [super init]; if (self) { <#statements#> } return self; } - (void)doHomework:(NSString *)name period:(NSInteger)second score:(NSInteger)score; ``` 11. 方法如果有多个参数的情况下需要注意是否需要介词和连词。很多时候在不知道如何抉择测时候思考下苹果的一些 API 的方法命名。 ```objective-c //good - (instancetype)initWithAge:(NSInteger)age name:(NSString *)name; - (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath; //bad - (instancetype)initWithAge:(NSInteger)age andName:(NSString *)name; - (void)tableView:(UITableView *)tableView :(NSIndexPath *)indexPath; ``` 12. `.m` 文件中的私有方法需要在顶部进行声明 13. 方法组之间也有个顺序问题。 - 在文件最顶部实现属性的声明、私有方法的声明/uff08很多人省去这一步/uff0c问题不大/uff0c但是蛮多第三方的库都写了/uff0c看起来还是会很方便/uff0c建议书写/uff09。 - 在生命周期的方法里面/uff0c比如 viewDidLoad 里面只做界面的添加/uff0c而不是做界面的初始化/uff0c所有的 view 初始化建议放在 getter 里面去做。往往 view 的初始化的代码长度会比较长、且一般会有多个 view 所以 getter 和 setter 一般建议放在最下面/uff0c这样子顶部就可以很清楚的看到代码的主要逻辑。 - 所有button、gestureRecognizer 的响应事件都放在这个区域里面/uff0c不要到处乱放。 文件基本上就是 ```objective-c //___FILEHEADER___ #import "___FILEBASENAME___.h" /*ViewController*/ /*View&&Util*/ /*model*/ /*NetWork InterFace*/ /*Vender*/ @interface ___FILEBASENAMEASIDENTIFIER___ () @end @implementation ___FILEBASENAMEASIDENTIFIER___ #pragma mark - life cycle - (void)viewWillAppear:(BOOL)animated { [super viewDidAppear:animated]; } - (void)viewDidAppear:(BOOL)animated { [super viewDidAppear:animated]; } - (void)viewDidLoad { [super viewDidLoad]; self.title = <#value#>; } - (void)viewWillDisappear:(BOOL)animated { [super viewDidAppear:animated]; } - (void)viewDidDisappear:(BOOL)animated { [super viewDidAppear:animated]; } #ifdef DEBUG - (void)dealloc { NSLog(@"%s",__func__); } #endif #pragma mark - public Method #pragma mark - private method #pragma mark - event response #pragma mark - UITableViewDelegate #pragma mark - UITableViewDataSource //...(多个代理方法依次往下写) #pragma mark - getters and setters @end ``` ## 图片资源 1. 单个文件的命名 文件资源的命名也需要一定的规范/uff0c形式为/uff1a功能模块名_类别_功能_状态@nx.png [email protected]、[email protected] [email protected]、[email protected] 2. 资源的文件夹命名 最好也参考 App 按照功能模块建立对应的实体文件夹目录/uff0c最后到对应的目录下添加相应的资源文件。 ## 注释 1. 对于类的注释写在当前类文件的顶部 2. 对于属性的注释需要写在属性后面的地方。 //**
本文由 投稿者 创作,文章地址:https://blog.isoyu.com/archives/kanwanzhepiannimentuanduidedaimayehenguifan-2.html
采用知识共享署名4.0 国际许可协议进行许可。除注明转载/出处外,均为本站原创或翻译,转载前请务必署名。最后编辑时间为:9 月 15, 2019 at 07:26 上午