美文网首页
代码规范

代码规范

作者: 双鲶鱼 | 来源:发表于2017-08-29 18:16 被阅读0次

1.代码分三种类型:赋值语句,循环语句,判断语句。

2.每种代码间需要一个空行分开。(重要规范)

3.两元远算符之间需要空格分开:如等号,let a = 1(重要规范)

4.大括号的位置:苹果官方大括号是跟在方法后面(重要规范) ,如:

public func abc() {
    xxxxx;
    xxxxx;
}

5.声明变量不要一行多个,应该分成多行写:如int a, b, c应该写成

let a = 0
let b = 1
var c = ""

6.逗号,冒号后面需要有个空格:如(JSON)

func centralManager(_ central: CBCentralManager, didDiscover peripheral: CBPeripheral, advertisementData: [String : Any], rssi RSSI: NSNumber) {
}

7.每个方法间至少需要一个空行。

8.委托代码加上#pragma mark - 如:(iOS)
// MARK: - UICollectionViewDataSource, UICollectionViewDelegate
委托名要全名,这也可以用command+鼠标左键可以跳转到说明处,而且前后需要空一行空行

9.循环语句和判断语句内容为一句时依然需要大括号,为了方便以后扩展,方便自己和他人查看,维护。

10.一个方法体最好不要超过一个屏幕(大概25行),如果实在没办法要超过则需要很明确的代码注释。(可参考11点的做法)

11.写步骤类的代码注释最好加上步骤说明。如:

// 1.找到对应model
xxxxxxxxx

// 2.改变xx属性值
xxxxxxxxx

// 3.提交到服务器

12.重要业务方法需要加注释(重要规范),如:

/// 注释测试的方法(针对swift)
///
/// - Parameters:
///   - sender: 触摸对象
///   - other: 其他参数
/// - Returns: int类型数据
public func abc:(sender: UIButton, other: String) -> Int {

}

13.消除警告提高编译速度

14.没用的代码都删除掉。(因为如果是有历史性的代码在svn是保存的了)

15.if else 按照官方的格式书写:(两端都应该这样写)

if (a == b) {
    xxxx
} else if (a != b) {
    xxxx
} else {
    xxxx
}

16.视图以View结尾,控制器以ViewController结尾,TableViewCell以Cell结尾,CollectionViewCell以CollectionCell结尾,实体类以Model结尾(iOS)

17.实体类以Bean结尾(Android)

  1. 每个类头都需要注释,该文件的主要用途或者类的解释

19.举例

if (a == b) {
    xxxx

    for (xxx; xxx; xxx) {
    }

    xxxx
} else if (a != b) {
    for (xxx; xxx; xxx) {
        if (xxx) {
        }
    }
} else {
    for (xxx; xxx; xxx) {
        xxxx;
        
        break;
    }

    for (xxx; xxx; xxx) {
        xxxx;
        
        return;
    }
}

return xxx;

相关文章

  • Web 端代码规范

    目录 1、代码规范概述 2、代码规范流程搭建 3、代码规范细则 1、代码规范概述 良好的代码规范能够提供软件的可读...

  • 代码规范

    代码规范 1. 概述 欢迎使用前端代码规范, 这里借鉴、引用的是京东前端代码规范。 遵循代码规范的目的在于增强团队...

  • iOS 代码规范篇

    iOS 代码规范篇 iOS 代码规范篇

  • iOS(OC)开发之随感

    1.代码规范 规范很重要!规范很重要!规范很重要! 代码规范的重要性之-为什么谷歌要执行严格的代码编写规范http...

  • 前端学习的基本总结

    目录 1.为什要遵守代码规范 2.css代码规范 3.js代码规范与设计模式3.1 js代码规范3.2 设计模式 ...

  • 乐乎项目优化

    编程: 1、代码规范。架构规范、文件组织规范、命名规范、代码逻辑规范、资源存放。 一、使用cocoapod 二、代...

  • 小肤iOS开发代码规范_v1.0

    For Objective-C , 2018.8.2 Ⅰ.前言Ⅱ.命名规范Ⅲ.代码注释规范Ⅳ.代码格式化规范Ⅴ....

  • 代码规范

    代码规范 1. 概述 欢迎使用代码规范, 这个是我借鉴京东前端代码规范,组织的内部规范。旨在增强团队开发协作、提高...

  • PSR-2- Coding Style Guide 编码风格规范

    代码风格规范 本篇规范是 PSR-1 基本代码规范的继承与扩展。 本规范希望通过制定一系列规范化PHP代码的规则,...

  • PM篇

    PM 技术篇1.开发规范命名规范,异常处理规范,日志规范,统一框架,代码commit规范,代码评审规范,统一API...

网友评论

      本文标题:代码规范

      本文链接:https://www.haomeiwen.com/subject/yqfalxtx.html