如何向Go官方提交代码 蒙卓 hi@mzh.io 自我介绍 ● 后端工程师，主要写Go ● 业余搞Go官方库开发 ● 主要喜欢折腾ARM/MIPS 性能优化 ● 第一个中国Go 官方MIPS64 builder 维护者 目录 1. 为啥参与Go开发 2. 如何提交CL 3. 交流技巧 4. 参考资料 为啥参与Go开发？ 解决BUG 4000+ issue 2510 TODO 申请Gerrit（评审平台）账号 3. 安装go-codereview 工具 4. clone Go官方源 5. 切换开发分支 6. 做出修改和commit 7. 执行git mail 即可 https://golang.org/doc/contribute.html 如何提交CL 官方wiki 把大象放进冰箱 如何提交CL 发布周期 如何提交CL 1. typo

目录 第0章：关于《Go语言101》 - 为什么写这本书 第1章：致谢 第2章：Go语言简介 - 为什么Go语言值得学习 第3章：Go官方工具链 - 如何编译和运行Go程序 Go编程入门 第4章：程序源代码基本元素介绍 第5章：关键字和标识符 第6章：基本类型和它们的字面量表示 第7章：常量和变量 - 顺便介绍了类型不确定值和类型推断 第8章：运算操作符 - 顺便介绍了更多的类型推断规则 个Go新手程序员。 我放弃了写那本书。 放弃？《Go语言101》现在不是已经完成了 吗？ 那本曾经计划要写的书不是《Go语言101》。 放弃那本书的写作计划后，我通 过阅读很多官方Go文档和网络中的各种Go文章、关注Go官方项目的问题跟踪 列表和一些Go论坛、查看一些代码等途径， 逐渐地，我几乎消除了我所有关 于Go编程细节中的困惑。 我大概花了大约一年时间来消除这些困惑。 在这个时期，每当我消除了某个 。 一方面，这些封装为Go编 程带来了许多便利，使我们不用从头实现这些类型。 但另一方面，这些封装 隐藏了这些类型的内部结构， 从而对我们更深入地理解这些类型的值的行为 带来了一些障碍。 许多官方和非官方的Go教程都非常简单。 这些教程只涵盖了一般典型用例， 而忽略了许多细节。 这对鼓励新手Go程序员学习和使用Go非常有好处， 但另 一方面，这也使许多Go程序员对他们的Go知识掌握程度过度自信。

目录 第0章：关于《Go语言101》 - 为什么写这本书 第1章：致谢 第2章：Go语言简介 - 为什么Go语言值得学习 第3章：Go官方工具链 - 如何编译和运行Go程序 Go编程入门 第4章：程序源代码基本元素介绍 第5章：关键字和标识符 第6章：基本类型和它们的字面量表示 第7章：常量和变量 - 顺便介绍了类型不确定值和类型推断 第8章：运算操作符 - 顺便介绍了更多的类型推断规则 Go新手程序员。 我放弃了写那本书。 放弃？《Go语言101》现在不是已经完成了吗？ 那本曾经计划要写的书不是《Go语言101》。 放弃那本书的写作计划后，我通 过阅读很多官方Go文档和网络中的各种Go文章、关注Go官方项目的问题跟踪 列表和一些Go论坛、查看一些代码等途径， 逐渐地，我几乎消除了我所有关于 Go编程细节中的困惑。 我大概花了大约一年时间来消除这些困惑。 在这个时期，每当我消除了某个主 。 一方面，这些封装为Go编程 带来了许多便利，使我们不用从头实现这些类型。 但另一方面，这些封装隐藏 了这些类型的内部结构， 从而对我们更深入地理解这些类型的值的行为带来了 一些障碍。 许多官方和非官方的Go教程都非常简单。 这些教程只涵盖了一般典型用例，而 忽略了许多细节。 这对鼓励新手Go程序员学习和使用Go非常有好处， 但另一 方面，这也使许多Go程序员对他们的Go知识掌握程度过度自信。

目录 1 目录 第0章：关于《Go语言101》 - 为什么写这本书 第1章：致谢 第2章：Go语言简介 - 为什么Go语言值得学习 第3章：Go官方工具链 - 如何编译和运行Go程序 Go编程入门 第4章：程序源代码基本元素介绍 第5章：关键字和标识符 第6章：基本类型和它们的字面量表示 第7章：常量和变量 - 顺便介绍了类型不确定值和类型推断 第8章：运算操作符 - 顺便介绍了更多的类型推断规则 我感觉我仍然是一个Go新手程序员。 我放弃了写那本书。 放弃？《Go语言101》现在不是已经完成了吗？ 那本曾经计划要写的书不是《Go语言101》。 放弃那本书的写作计划后，我通过阅 读很多官方Go文档和网络中的各种Go文章、关注Go官方项目的问题跟踪列表和一些 Go论坛、查看一些代码等途径， 逐渐地，我几乎消除了我所有关于Go编程细节中的 困惑。 我大概花了大约一年时间来消除这些困惑。 在这个时期，每当我消除了某个主题的 实现这些类型的时候，进行了必要的封装。 一方面，这些封装为Go编程带来了许多 便利，使我们不用从头实现这些类型。 但另一方面，这些封装隐藏了这些类型的内 部结构， 从而对我们更深入地理解这些类型的值的行为带来了一些障碍。 许多官方和非官方的Go教程都非常简单。 这些教程只涵盖了一般典型用例，而忽略 了许多细节。 这对鼓励新手Go程序员学习和使用Go非常有好处， 但另一方面，这 也使许多Go程序员对他们的Go知识掌握程度过度自信。

N 用更少的代码，更短的编译时间，创建运行更快的程序，享受更多 的乐趣 对于学习 Go 编程语言的爱好者来说，这本书无疑是最适合你的一本书籍，这里包含了当前最全面的学习 资源。本书通过对官方的在线文档、名人博客、书籍、相关文章以及演讲的资料收集和整理，并结合我自 身在软件工程、编程语言和数据库开发的授课经验，将这些零碎的知识点组织成系统化的概念和技术分类 来进行讲解。 随着软件规模的不 行比较（书中会使用大家所熟知的缩写 “OO” 来表示面向对象）。 本书将会从最基础的概念讲起，同时也会讨论一些类似在应用 goroutine 和 channel 时有多少种不同的模 Go入门指南 - 1 - 本文档使用 看云 构建 式，如何在 Go 语言中使用谷歌 API，如何操作内存，如何在 Go 语言中进行程序测试和如何使用模板来 开发 Web 应用这些高级概念和技巧。 在本书的第一部分，我们将会讨论 代码示例，以避免你在不了 解某些高级概念的情况下而感到迷茫。 我们通过 227 个完整的代码示例和书中的解释说明来对所有涉及到的概念和技巧进行彻底的讲解，你可以 Go入门指南 - 2 - 本文档使用 看云 构建 下载这些代码到你的电脑上运行，从而加深对概念的理解。 本书会尽可能地将前后章节的内容联系起来，当然这也同时要求你通过学习不同的知识来对一个问题提出 尽可能多的解决方案。记住，

你也可以带上参数，详情 请参考go help testflag go doc go doc 很多人说go不需要任何的第三方文档，例如chm手册之类的（其实我已经做了一个了，chm手册），因为它内部就有一 个很强大的文档工具。 如何查看相应package的文档呢？ 例如builtin包，那么执行go doc builtin 如果是http包，那么执行go doc net/http 查看某一个包里面的函数，那么执行godoc -http=:8080。然后在浏览器中打开 127.0.0.1:8080，你将会看到一个golang.org的本地copy版本，通过它你可以查询pkg文档等其它内容。如果你设 置了GOPATH，在pkg分类下，不但会列出标准包的文档，还会列出你本地GOPATH中所有项目的相关文档，这对于经常 被墙的用户来说是一个不错的选择。 其它命令 其它命令 go还提供了其它很多的工具，例如下面的这些工具 go fix 管理和切换多个Go编译环境 支持Go语言交叉编译 与Go标准一致的项目管理方式 基于GOPATH的包浏览器 基于GOPATH的编译系统 基于GOPATH的Api文档检索 Go语言的编辑支持 类浏览器和大纲显示 Gocode(代码自动完成工具)的完美支持 Go语言文档查看和Api快速检索 代码表达式信息显示F1 源代码定义跳转支持F2 Gdb断点和调试支持 gofmt自动格式化支持 其他特征 支持多国语言界面显示

6 生成代码文档 3.7 其它工具 3.8 Go 性能说明 3.9 与其它语言进行交互 第4章：基本结构和基本数据类型 4.1 文件名、关键字与标识符 4.2 Go 程序的基本结构和要素 4.3 常量 4.4 变量 4.5 基本类型和运算符 4.6 字符串 4.7 strings 和 strconv 包 4.8 时间和日期 4.9 指针 - 2 - 本文档使用 书栈(BookStack 类型的切片 8.5 map 的排序 8.6 将 map 的键值对调 第9章：包（package） 9.1 标准库概述 9.2 regexp 包 9.3 锁和 sync 包 - 3 - 本文档使用 书栈(BookStack.CN) 构建 9.4 精密计算和 big 包 9.5 自定义包和可见性 9.6 为自定义包使用 godoc 9.7 使用 go install 安装自定义包 结构体、集合和高阶函数 第12章：读写数据 12.1 读取用户的输入 12.2 文件读写 12.3 文件拷贝 12.4 从命令行读取参数 12.5 用 buffer 读取文件 - 4 - 本文档使用 书栈(BookStack.CN) 构建 12.6 用切片读写文件 12.7 用 defer 关闭文件 12.8 使用接口的实际例子：fmt.Fprintf 12.9 格式化 JSON 数据

https://github.com/spf13/cobra – 包名必须小写且符合Unix文件命令规则 – 包名全称，规则：[git仓库]/[用户]/[仓库路径] • 包里文件 – 源代码 – 测试代码 – API文档 – 其他资源文件 按规则可找到源代码，方便阅读 包导出名 • 包中定义的 – 类型 – 常量 – 变量 – 函数 • 如果首字母大写，则是全局可访问的 函数申明 • 使用 func 关键字申明函数 返回函数访问隶属函数实例的变量称为“闭包” Go语言入门资源 • 语言概览 – 官方Go指南，gotour – 系统的学习，go语言教程 • 程序结构 – 包/子包（main） • Go源代码 – 函数（main, init） • 命令行工具 • 编程参考与规范 – 官方文档”Effective Go/实效Go编程” – 官方文档，库参考文档， https://godoc.org/ • 中级资源 Ultimate

个例子里面只是用了两 个类型，也可以改成如下这样的定义，然后返回的时候不用带上变量名，因为直接在函数里面初始化 了。但如果函数是导出的(首字母大写)，官方建议：最好命名返回值，因为不命名返回值，虽然使得代码 更加简洁了，但是会造成生成的文档可读性差。 变参 Go函数支持变参。接受变参的函数是有着不定数量的参数的。为了做到这点，首先需要定义函数使其接 受变参： arg ...int { Reader Writer } 反射 Go语言实现了反射，所谓反射就是能检查程序在运行时的状态。一般用到的包是 reflect 包。如何运 用 reflect 包，官方的这篇文章详细的讲解了 reflect 包的实现原理， laws of reflection 链接地 址为 http://golang.org/doc/articles/laws_of_reflection 都是 很明显的，不含有任何隐含的东西，在错误处理方案的设计中也贯彻了这一思想。 在C语言里面是通过返回 -1 或者 NULL 之类的信息来表示错误，但是对于使用者来说，不查看相应的API 说明文档，根本搞不清楚这个返回值究竟代表什么意思，比如:返回0是成功，还是失败,而 Go 定义了一 个叫做 error 的类型，来显式表达错误。在使用时，通过把返回的 error 变量与 nil 的比较，来判定操

这是一个未解决的 Issue，目的是希望 Go 团队能够在 testing 包中使用文档来说明编译器优化的情况，进而避免基准测试测量不准 确的问题 ● https://github.com/golang/go/issues/23471 ○ 这是一个未解决的 Issue，目的是希望 Go 团队能够发布一篇官方文档来详述如何科学的对 Go 程序进行性能测试 ○ 当然，本次分享的 PPT 其实解决了这个问题