控制代码

如果您碰到了一个乱糟糟的项目,恭喜你走运了。代码不是一天乱起来的,嘈乱代码的背后必然有一个自负而不自知的程序员和一位疏于管理的Manager。遇到这种情况,只能是自求多福了。有标准总好过没有标准。

从代码的整洁度上就可以看出一个程序员的水平,规范其实就是让你养成一种良好习惯的标杆,在此面前我们应该顺从(本篇以OC为例)。

  1. 单页代码最好控制在800行以内,每个方法最好不要超过100行,过多建议对代码进行重构

  2. 相同的逻辑方法定义避免在多个地方出现,尽量将公用的类、方法抽取出来

  3. 删除未被使用的代码,不要大片注释未被使用的代码,确定代码不会使用,请及时删除

  4. 对其他项目中copy过来的代码,根据具体需要更新代码风格,及时删除未被使用的代码

  5. 项目中所有Group或者文件名称(图片名字等),不要使用汉字命名,尽量使用英文命名,国内特有名词可以使用拼音。

  6. 项目中所有Group都需要在项目目录中存在一个真实的目录,Group中的文件与真实目录中文件一一对应。

  7. 请在项目中写必要代码的注释

  8. 请多使用 #pragma mark - Mark Name 对方法进行分组 。如:

    #pragma mark - **********View lifeCycle******
    
  9. 所有类名称以项目工程开头命名,如:“JS”(简书)。针对不同视图控制器,在末尾添加后缀,如: UIButton 后缀添加“Button"或大家皆知的简写,NSArray的变量命名为xxxArray等。

  10. 类、方法、属性等命名,做到见名知意,采用驼峰式命名规则。

  11. 根据资源类型或者所属业务逻辑对项目资源进行分组,使得整个项目结构清晰明了;整个项目保持一种代码书写风格。

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

    #define PI 3.1415926
    
  13. 当使用条件语句编码时,不要嵌套if语句,多个返回语句也是OK。

    - (void)testMethod {
       if (![testSome boolValue]) {// 不合适就返回,下面做处理
       return;
      }
     //Do something important
    }
    
  14. 当方法通过引用来返回一个错误参数,判断返回值而不是错误变量。在成功的情况下,有些Apple的APIs记录垃圾值(garbage values)到错误参数(如果non-NULL),那么判断错误值会导致false负值和crash。

    NSError *error;
    if (![self trySomethingWithError:&error]) {
      // Handle Error
    }
    
  15. 当参数过长时,每个参数占用一行,以冒号对齐。如:

    - (void)aboutFisrtNumber:(NSString *)oneStr
              withNextNumber:(NSString *)twoStr
              withLastNumber:(NSString *)threeStr{
    // do something
    }
    
  16. 一行很长的代码应该分成两行代码,下一行用两个空格隔开

    self.productsRequest = [[JSProductsRequest alloc] 
      initWithProductIdentifiers:productIdentifiers];
    
  17. 删除多余的空行,所有方法与方法之间空1行,所有代码块之间空1行。变量声明后需要空1行,如果需要分类区别,各类别之间空1行。条件、循环,选择语句,整个语句结束,需要空1行。最后一个括弧之前不空行。注释与代码之间不空行。

     #pragma 与方法之间空1行
    
  18. 每行代码最多不得超过100个字

  19. 如果类声明中包含多个protocol,每个protocol占用一行,缩进2个字符如:

      @interface BootViewController : UITableViewController<</p>
      UITableViewDelegate,
      UITableViewDataSource,
      UITextFieldDelegate,
      UITextViewDelegate
      >{
      // code
      }
    
  20. 图片命名:采用单词全拼,或者大家公认无岐义的缩写(比如:nav,bg,btn等);采用“模块+功能”命名法,模块分为公共模块、私有模块。公共模块主要包括统一的背景,导航条,标签,公共的按钮背景,公共的默认图等等;私有模块主要根据app的业务;功能模块划分,比如用户中心,消息中心等。建议背景图采用以bg作前缀,按钮背景采用btn作前缀。

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

推荐阅读更多精彩内容