当越多人思考他们自己的格式风格的时候，他们就变得更加固执于此了 错误的结论：自动格式器必须要有很多选项！ 但是有很多选项的格式器其实违背他们的目的 此外，支持很多选项是难的 尊重用户的想法是最关键的 处理注释是很难的 语言本身也会增加很多额外的复杂度（比如，C的宏） 4/21/2015 gofmt 的文化演变 http://127.0.0.1:3999/gofmt-cn.slide#1 7/34 4/21/2015 gofmt 的文化演变 http://127.0.0.1:3999/gofmt-cn.slide#1 9/34 gofmt的基本结构 源代码的处理 基本的格式化 附加：注释的处理 完善：代码和注释的对齐 但是，没有牛X的通用布局算法 相反的：基于节点的精细优化 4/21/2015 gofmt 的文化演变 http://127.0.0.1:3999/gofmt-cn.slide#1 4/21/2015 gofmt 的文化演变 http://127.0.0.1:3999/gofmt-cn.slide#1 13/34 注释的处理 注释可以出现在程序的任何两个词汇之间. 通常情况下，不能很明显的知道注释属于哪个 AST 节点. 注释经常是成组出现: // A CommentGroup represents a sequence of comments // with no

拥有较好的项目文件纵览和导航能力，可以同时编辑多个源文件并设置书签，能够匹配括号，能够跳 转到某个函数或类型的定义部分。 5. 完美的查找和替换功能，替换之前最好还能预览结果。 6. 可以注释或取消注释选中的一行或多行代码。 7. 当有编译错误时，双击错误提示可以跳转到发生错误的位置。 8. 跨平台，能够在 Linux、Mac OS X 和 Windwos 下工作，这样就可以专注于一个开发环境。 Go 程序和包文件中提取顶级声明的首行注释以及每个对象的相关注释，并生成相关文 档。 它也可以作为一个提供在线文档浏览的 web 服务器，http://golang.org 就是通过这种形式实现的。 一般用法 go doc package 获取包的文档注释，例如： go doc fmt 会显示使用 godoc 生成的 fmt 包的 文档注释。 go doc package/subpackage package/subpackage 获取子包的文档注释，例如： go doc container/list 。 go doc package function 获取某个函数在某个包中的文档注释，例如： go doc fmt Printf 会显 示有关 fmt.Printf() 的使用说明。 这个工具只能获取在 Go 安装目录下 .../go/src 中的注释内容。此外，它还可以作为一个本地文档浏览

拥有较好的项目文件纵览和导航能力，可以同时编辑多个源文件并设置书签，能够匹配括号，能够跳转到某个函 数或类型的定义部分。 5. 完美的查找和替换功能，替换之前最好还能预览结果。 6. 可以注释或取消注释选中的一行或多行代码。 7. 当有编译错误时，双击错误提示可以跳转到发生错误的位置。 8. 跨平台，能够在 Linux、Mac OS X 和 Windows 下工作，这样就可以专注于一个开发环境。 Go 程序和包文件中提取顶级声明的首行注释以及每个对象的相关注释，并生成相关文档。 它也可以作为一个提供在线文档浏览的 web 服务器，http://golang.org 就是通过这种形式实现的。 一般用法 go doc package 获取包的文档注释，例如： go doc fmt 会显示使用 godoc 生成的 fmt 包的文档注释。 go doc package/subpackage package/subpackage 获取子包的文档注释，例如： go doc container/list 。 go doc package function 获取某个函数在某个包中的文档注释，例如： go doc fmt Printf 会显示有关 fmt.Printf() 的使用说明。 这个工具只能获取在 Go 安装目录下 .../go/src 中的注释内容。此外，它还可以作为一个本地文档浏览

标注，以避免歧义。 0. 写在前面 hello‑algo.com 4 本书部分放弃了编程语言的注释规范，以换取更加紧凑的内容排版。注释主要分为三种类型：标题注释、内容 注释、多行注释。 /* 标题注释，用于标注函数、类、测试样例等 */ // 内容注释，用于详解代码 /** * 多行 * 注释 */ 0.2.3. 在动画图解中高效学习 视频和图片相比于文字的信息密度和结构化程度更 ，将文字内容（一般在图的上方）对齐到 图中内容，综合来理解。 Figure 0‑3. 动画图解示例 0.2.4. 在代码实践中加深理解 本书的配套代码托管在GitHub 仓库，源代码包含详细注释，配有测试样例，可以直接运行。 ‧ 若学习时间紧张，建议至少将所有代码通读并运行一遍。 ‧ 若时间允许，强烈建议对照着代码自己敲一遍。相比于读代码，写代码的过程往往能带来新的收获。 0. 写在前面

标注，以避免歧义。 0. 写在前面 hello‑algo.com 4 本书部分放弃了编程语言的注释规范，以换取更加紧凑的内容排版。注释主要分为三种类型：标题注释、内容 注释、多行注释。 /* 标题注释，用于标注函数、类、测试样例等 */ // 内容注释，用于详解代码 /** * 多行 * 注释 */ 0.2.3. 在动画图解中高效学习 视频和图片相比于文字的信息密度和结构化程度更 ，将文字内容（一般在图的上方）对齐到 图中内容，综合来理解。 Figure 0‑3. 动画图解示例 0.2.4. 在代码实践中加深理解 本书的配套代码托管在GitHub 仓库，源代码包含详细注释，配有测试样例，可以直接运行。 ‧ 若学习时间紧张，建议至少将所有代码通读并运行一遍。 ‧ 若时间允许，强烈建议对照着代码自己敲一遍。相比于读代码，写代码的过程往往能带来新的收获。 0. 写在前面

尽管高级编程语言代码比底层机器指令友好和易懂，我们还是需要一些注释来 帮助自己和其他程序员理解我们所写的代码。 在下一节的程序示例中，我们 可以看到很多注释。 一个简单的Go示例程序 为了对各种代码元素有一个更清楚的认识，让我们来看一个简短的Go示例程 序。 和很多其流行语言一样，Go使用//来起始一个行注释，使用一个/*和*/ 对来包裹一个块注释。 下面是这个Go示例程序。请注意阅读其中的注释。程序之后有更多解释。 1| 流程 控制代码块的信息。 更多的特殊的流程控制代码块将在以后的其它文章中介 绍。 空行常常用来增加代码的可读性。 上面的程序中也包涵了很多注释，但它们 大多是为了Go初学者快速理解的目的而加入的。 我们应该尽量使代码自解 释，只在确实需要解释的地方进行注释。 关于代码断行 像很多其它流行编程语言一样，Go也使用一对大括号{ and }来形成一个显式 代码块。但是在Go代码中，编码样式风格有一些限制。 14的时候，所有出现在代码中的3.1416都 得逐个修改。 有了具名常量的帮助，我们只需修改对应常量描述中的3.1416 即可。 这是常量声明的主要作用。当然常量声明也可常常增加代码的可读性 （代码即注释）。 以后，我们使用非常量这一术语表示不是常量的值。 下一节将要介绍的变量 就属于非常量。 注意，常量可以直接声明在包中，也可以声明在函数体中。 声明在函数体中 的常量称为局部常量（local

尽管高级编程语言代码比底层机器指令友好和易懂，我们还是需要一些注释来帮助 自己和其他程序员理解我们所写的代码。 在下一节的程序示例中，我们可以看到很 多注释。 一个简单的Go示例程序 为了对各种代码元素有一个更清楚的认识，让我们来看一个简短的Go示例程序。 和 很多其流行语言一样，Go使用//来起始一个行注释，使用一个/*和*/对来包裹一 个块注释。 下面是这个Go示例程序。请注意阅读其中的注释。程序之后有更多解释。 1| 于流程控制代码块 的信息。 更多的特殊的流程控制代码块将在以后的其它文章中介绍。 空行常常用来增加代码的可读性。 上面的程序中也包涵了很多注释，但它们大多是 为了Go初学者快速理解的目的而加入的。 我们应该尽量使代码自解释，只在确实需 要解释的地方进行注释。 关于代码断行 像很多其它流行编程语言一样，Go也使用一对大括号{ and }来形成一个显式代码 块。但是在Go代码中，编码样式风格有一些限制。 14的时候，所有出现在代码中的3.1416都得逐个修改。 有了具 名常量的帮助，我们只需修改对应常量描述中的3.1416即可。 这是常量声明的主 要作用。当然常量声明也可常常增加代码的可读性（代码即注释）。 第7章：常量和变量 37 以后，我们使用非常量这一术语表示不是常量的值。 下一节将要介绍的变量就属于 非常量。 注意，常量可以直接声明在包中，也可以声明在函数体中。 声明在函数体中的常量

尽管高级编程语言代码比底层机器指令友好和易懂，我们还是需要一些注释来 帮助自己和其他程序员理解我们所写的代码。 在下一节的程序示例中，我们可 以看到很多注释。 一个简单的Go示例程序 为了对各种代码元素有一个更清楚的认识，让我们来看一个简短的Go示例程 序。 和很多其流行语言一样，Go使用//来起始一个行注释，使用一个/*和*/对 来包裹一个块注释。 下面是这个Go示例程序。请注意阅读其中的注释。程序之后有更多解释。 1 于流程控制 代码块的信息。 更多的特殊的流程控制代码块将在以后的其它文章中介绍。 空行常常用来增加代码的可读性。 上面的程序中也包涵了很多注释，但它们大 多是为了Go初学者快速理解的目的而加入的。 我们应该尽量使代码自解释，只 在确实需要解释的地方进行注释。 关于代码断行 像很多其它流行编程语言一样，Go也使用一对大括号{ and }来形成一个显式代 码块。但是在Go代码中，编码样式风格有一些限制。 候，它的值在第n个常量描述中的值为n（从0开始）。 所以iota只对含有多个 常量描述的常量声明有意义。 iota和常量描述自动补全相结合有的时候能够给Go编程带来很大便利。 比如， 下面是一个使用了这两个特性的例子。 请阅读代码注释以了解清楚各个常量被 绑定的值。 package main func main() { const ( k = 3 // 在此处，iota == 0 m float32

涉及到编程语言之间不一致的名词，本书均以 Python 为准，例如使用 None 来表示“空”。 ‧ 本书部分放弃了编程语言的注释规范，以换取更加紧凑的内容排版。注释主要分为三种类型：标题注 释、内容注释、多行注释。 /* 标题注释，用于标注函数、类、测试样例等 */ // 内容注释，用于详解代码 /** * 多行 * 注释 */ 0.2.2. 在动画图解中高效学习 相较于文字，视频和图片具有更高的信息密度和结 综合两者来理解内容。 Figure 0‑2. 动画图解示例 0. 前言 hello‑algo.com 4 0.2.3. 在代码实践中加深理解 本书的配套代码托管在GitHub 仓库，源代码包含详细注释，并附有测试样例，可直接运行。 如果学习时间有限，建议你至少通读并运行所有代码。如果时间充裕，建议参照代码自行敲一遍。与仅阅读 代码相比，编写代码的过程往往能带来更多收获。 Figure 0‑3 rt, target, &state, &nums, &res) return res } 下图展示了数组 [4, 4, 5] 和目标元素 9 的回溯过程，共包含四种剪枝操作。请你将图示与代码注释相结合， 理解整个搜索过程，以及每种剪枝操作是如何工作的。 13. 回溯 hello‑algo.com 269 Figure 13‑14. 子集和 II 回溯过程 13.4. N 皇后问题

格式规范 正文 正文 请参看已有章节的规范，要注意的是，每个章节在底部都需要有一个links节，包含“目录”，“上一节”和“下一 节”的链接。 代码 代码 代码要go fmt后提交。注释文件注明其所属章节。 如何编译 如何编译 build.go依赖markdown的一个解析包，所以第一步先 go get github.com/russross/blackfriday (point-max) "go tool fix -diff")) 6. 恭喜你，你现在可以体验在神器中开发Go的乐趣。默认speedbar是关闭的，如果打开需要把 ;; (speedbar 1) 前面的注释去掉，或者也可以通过 M-x speedbar 手动开启。 Eclipse Eclipse Eclipse也是非常常用的开发利器，以下介绍如何使用Eclipse来编写Go程序。 27 接下来我们的例子采用前面的数据库表Userinfo，现在我们建立相应的struct type Userinfo struct { Uid int `PK` //如果表的主键不是id，那么需要加上pk注释，显式的说这个字段是主键 Username string Departname string Created time.Time 127 } 注意一点