代码分四种类型:赋值语句,循环语句,判断语句,控制语句。
每种代码间需要一个空行分开,如果严格按照要求做,代码块思维会很容易形成。(重要规范)
两元远算符之间需要空格分开:如等号,
let a = 1
(重要规范)大括号的位置:苹果官方大括号是跟在方法后面(重要规范) ,如:
public func abc() {
xxxxx;
xxxxx;
}
- 声明变量不要一行多个,应该分成多行写:如int a, b, c应该写成
let a = 0
let b = 1
var c = ""
- 逗号,冒号后面需要有个空格:如(JSON)
func centralManager(_ central: CBCentralManager, didDiscover peripheral: CBPeripheral, advertisementData: [String : Any], rssi RSSI: NSNumber) {
}
每个方法间至少需要一个空行。
循环语句和判断语句内容为一句时依然需要大括号,为了方便以后扩展,方便自己和他人查看,维护。
一个方法体最好不要超过一个屏幕(大概25行),如果实在没办法要超过则需要很明确的代码注释。(可参考10点的做法)
写步骤类的代码注释最好加上步骤说明。如:
// 1.找到对应model
xxxxxxxxx
// 2.改变xx属性值
xxxxxxxxx
// 3.提交到服务器
xxxxxxxx
- 重要业务方法需要加注释(重要规范),如:
/// 注释测试的方法(针对swift)
///
/// - Parameters:
/// - sender: 触摸对象
/// - other: 其他参数
/// - Returns: int类型数据
public func abc:(sender: UIButton, other: String) -> Int {
}
消除警告提高编译速度
没用的代码都删除掉。(因为如果是有历史性的代码在git是保存的了)
if else 按照官方的格式书写:(两端都应该这样写)
if (a == b) {
xxxx
} else if (a != b) {
xxxx
} else {
xxxx
}
每个类头都需要注释,该文件的主要用途或者类的解释
代码规范举例
if (a == b) {
xxxx
for (xxx; xxx; xxx) {
xxxx;
}
xxxx
} else if (a != b) {
for (xxx; xxx; xxx) {
if (xxx) {
xxxxx;
}
}
} else {
for (xxx; xxx; xxx) {
xxxx;
break;
}
for (xxx; xxx; xxx) {
xxxx;
return;
}
}
return xxx;