31.md

代码注释格式

---

当需要的时候，注释应该被用来解释为什么特定代码做了某些事情。所使用的任何注释必须保持最新，否则就删除掉。

通常应该避免一大块注释，代码就应该尽量作为自身的文档，只需要隔几行写几句说明。这并不适用于那些用来生成文档的注释。

文件注释

采用Xcode自动生成的注释格式，修改部分参数：

//
//  AppDelegate.m
//  LeFit
//
//  Created by Zhang Wen on 15-3-22.
//  Copyright (c) 2015 Appscomm LLC. All rights reserved.
//

其中项目名称、创建人、公司/组织版权需要填写正确。

import注释

如果有一个以上的 import 语句，就对这些语句进行分组。每个分组的注释是可选的。

注：对于模块使用@import语法。

    // Frameworks
    @import QuartzCore;

    // Models
    #import "NYTUser.h"

    // Views
    #import "NYTButton.h"
    #import "NYTUserView.h"

方法注释

采用Javadoc的格式，可以使用Xcode插件VVDocumenter-Xcode快速添加，只需输入///即可

Xcode 8后请使用自带扩展插件，快捷键Option＋Command＋／

/**
 <#Description#>

 @param tableView <#tableView description#>
 @param section <#section description#>
 @return <#return value description#>
 */
- (NSString *)tableView:(UITableView *)tableView titleForHeaderInSection:(NSInteger)section {
    return [self.familyNames objectAtIndex:section];
}

代码块注释

单行的用//+空格开头，多行的采用/* */注释

TODO注释

TODO 很不错, 有时候注释确实是为了标记一些未完成的或完成的不尽如人意的地方, 这样一搜索就知道还有哪些活要干, 日志都省了。

格式：//TODO: 说明

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    //TODO: 增加初始化
    return YES;
}