Go微服务框架rpcx作者 • Go并发编程实战课专栏作者 • 《Scala集合技术手册》作者 目 录 Go 版本管理历史 01 认识 Go Module 02 使用 Go Module 03 血泪史 04 Go Module 未来特性 05 Go版本管理历史 第一部分 Go版本历史 GOPATH /2012/go 1.0 goven /2012/ .../kr/goven godep 11 • 又是一堆go命令 不兼容 认识 Go Module 第二部分 概念 什么是 module? module的定义 module vs package minor 语义化版本 2.0.0 go.mod path & go indrective & version major.minor.patch-beta+metadata go.mod 文件 go.mod incompatible 版本>=2,但是没有go.mod indirect 依赖引入的依赖，go.mod不包含 go.mod 文件 exclude & replace exclude 排除特定的版本 replace 替换特定的版本、或者所有版本 go.mod 文件 replace中更多配置 替换bbolt所有版本 替换x/net v1.2.3版本 使用本地文件替换 go

v2, v3 就是版本化.. 2.1 本质 向后兼容 - API 的稳定性要求避免破坏性的更改。在进行更新或修改时，应保 持对现有功能的支持，以防止影响已部署的应用程序或客户端。 只有做到对当前版本 API 不发布任何 breaking changes 才能向后兼容。 2.1 本质 实际上的 API Versioning 1. API 有版本概念 2. 同一个版本的每次 API 变更都能向后兼容 不能向后兼容的发布只会发生在新版本中 2.2 实现效果 一个 Versioned 的 API，将提供多套稳定版 本的 API 在线上，每套 API 有独立的逻辑、 实例、资源，各版本之间互不影响。客户端 可以自由选择调用哪个版本。 How Part 3/4 1. Support Policy 2. API Version 3. Webhook Version 4. 公开文档 5. 系统架构 6. 版本维护 3 3.1 Support Policy 每新增一个版本都会带来额外的维护成本，所以版本发布频率高的企 业，版本支持时间较短；版本发布频率低的企业，版本支持时间较长。 企业应根据自身的业务特性选择合适的 Support Policy。 3.2 API version v1/v2/v3 这种数值类型的版本号，没有生命周期，无法约束废弃时间。以 日期作为 API Version 对于生命周期以及兼容性可以有更加清晰的定义。

就是实践，运行它的代码，修改并尝试更多的方 案。因此，你绝对不可以忽略书中的 130 个代码练习，这将对你学习好 Go 语言有很大的帮助。比如，我 们就为斐波那契算法提供了 13 个不同的版本，而这些版本都使用了不同的概念和技巧。 你可以通过访问本书的 官方网站 下载书中的代码（译者注：所有代码文件已经包括在 GitHub 仓库中）， 并获得有关本书的勘误情况和内容更新。 为了让你在成为 18 章可以作为你在开发时的一个参考手册， 因为当中包含了众多的有价值的代码片段以及相关的解释说明。 最后要说明的是，你可以通过完整的索引来快速定位你需要阅读的章节。书中所有的代码都在 Go1.4 版本 下测试通过。 这里有一段来自在 C++、Java 和 Python 领域众所周知的专家 Bruce Eckel 的评论： “作为一个有着 C/C++ 背景的开发者，我在使用 Go 语言时仿佛呼吸到了新鲜空气一般，令人心旷神 直到 2009 年 11 月 10 日，开发团队将 Go 语言项目以 BSD-style 授权（完全开源）正式公布在 Linux 和 Mac OS X 平台上的版本。Hector Chu 于同年 11 月 22 日公布了 Windows 版本。 作为一个开源项目，Go 语言借助开源社区的有生力量达到快速地发展，并吸引更多的开发者来使用并改 善它。自该开源项目发布以来，超过 200 名非谷歌员工的贡献者对

之后，决定每天抽出一点时间来进行翻译的工作，并且以 开源的形式免费分享给有需要的 Go 语言爱好者。 尽管该书对目前 Go 语言版本来说有小部分内容相对过时，但是为当下不可多得的好书，相关内容已获得作者同意根 据当前 Go 语言版本进行修改而不作出特别声明。 该翻译版本已获得原作者（Ivo Balbaert）本人授权，并表示支持开源事业的发展！ 14.9 实现 Futures 模式 如果你喜欢本书 解决方案。记住，学习一门新语言的最佳方式就是实践，运行它的代码，修改并尝试更多的方案。因此，你绝对不可 以忽略书中的 130 个代码练习，这将对你学习好 Go 语言有很大的帮助。比如，我们就为斐波那契算法提供了 13 个不同的版本，而这些版本都使用了不同的概念和技巧。 你可以通过访问本书的 官方网站 下载书中的代码（译者注：所有代码文件已经包括在 GitHub 仓库中），并获得 有关本书的勘误情况和内容更新。 为了让你在成为 12 - 本文档使用 书栈(BookStack.CN) 构建 的有价值的代码片段以及相关的解释说明。 最后要说明的是，你可以通过完整的索引来快速定位你需要阅读的章节。书中所有的代码都在 Go1.4 版本下测试通 过。 这里有一段来自在 C++、Java 和 Python 领域众所周知的专家 Bruce Eckel 的评论： “作为一个有着 C/C++ 背景的开发者，我在使用 Go 语言时仿佛

更多。 gc编译器是Go官方工具链中一个组件。 Go官方工具链的使用将在下一篇文章 中介绍。 Go官方工具链1.0发布于2012年三月。 Go语言规范的最新版本和Go 官方工具链的最新版本总是保持一致。 每年Go官方工具链发行两个主版本。 自从Go语言正式发布后，Go的语法变化很小。 但是标准编译器gc却在不断地 改进。 使用早期的gc编译的程序在运行的时候在每次垃圾回收的结尾常常会 有明显的停顿。 我们也可以使用工具[GoTV](https://go101.org/apps-and-libs/gotv.html)来安装多 个Go工具链版本，并方便和谐地使用它们。 Go官方工具链的版本和其所支持的最高Go语言版本是一致的。 比如，Go官方 工具链1.21.x版本支持从1.0到1.21的所有Go语言版本。 为了从任意目录运行Go官方工具链中工具命令（通过go命令）， Go官方工具 链安装目录下的bin子目录路径必须配置在PATH环境变量中。 链安装目录下的bin子目录路径必须配置在PATH环境变量中。 当使用安装程序 安装Go官方工具链时，安装程序很可能已经自动地将此配置好了。 Go官方工具链近来的版本均支持一个称为Go模块（Go modules）的特性，用 来管理项目依赖。 此特性在版本1.11中被试验性地引入并从版本1.16开始被默 认支持。 我们应该了解一个环境变量：GOPATH。 此环境变量的默认值为当前用户的 HOME目录下的名为go文件夹对应的目录路径。

项目依赖的模块过多，无从下手是否应当升级模块版本 • 各个模块孤立设计，单独看待每个模块可替换性很高， 开发体系难以建立，开发规范难以统一 模块化设计-模块聚合设计 • 框架核心维护较全面的通用基础模块，降低基础模块选择成本 • 我们只需要维护一个统一的框架版本，而不是数十个模块版本 • 我们只需要了解一个框架的内容变化，而不是数十个模块的内容变化 • 升级的时候只需要升级一个框架版本，而不是数十个模块版本的升级 • • 减轻心智负担，提高模块可维护性，更容易保证各业务项目的模块版本一致性 改进： 模块化设计-常见问题 1. 模块低耦设计：文件层面的源文件下载与模块之间的逻辑耦合没有直接关系 2. 框架核心精简：功能强大且代码精简，包含测试与示例代码共8MB容量 3. 编译语言特性：编译型语言和解释型语言的模块管理逻辑不太一样 虽然框架每一个模块都按照低耦合设计，模块可以选择性引入，但在使用时也得全量下载完整框架代码。 项目依赖的模块过多，项目无从下手是否应当升级这些模块版本 • 各个模块孤立设计，单独看待每个模块可替换性很高，开发体系难以建 立，开发规范难以统一 改进： • 框架核心维护较全面的通用基础模块，降低基础模块选择成本 • 我们只需要维护一个统一的框架版本，而不是数十个模块版本 • 我们只需要了解一个框架的内容变化，而不是数十个模块的内容变化 • 升级的时候只需要升级一个框架版本，而不是数十个模块版本的升级 • 统一的

力更多。 gc编译器是Go官方工具链中一个组件。 Go官方工具链的使用将在下一篇文章 中介绍。 Go官方工具链1.0发布于2012年三月。 Go语言规范的最新版本和Go官 方工具链的最新版本总是保持一致。 每年Go官方工具链发行两个主版本。 自从Go语言正式发布后，Go的语法变化很小。 但是标准编译器gc却在不断地 改进。 使用早期的gc编译的程序在运行的时候在每次垃圾回收的结尾常常会有 明显的停顿。 我们也可以使用工具[GoTV](https://go101.org/apps-and-libs/gotv.html)来安装多个 Go工具链版本，并方便和谐地使用它们。 Go官方工具链的版本和其所支持的最高Go语言版本是一致的。 比如，Go官方 工具链1.21.x版本支持从1.0到1.21的所有Go语言版本。 为了从任意目录运行Go官方工具链中工具命令（通过go命令）， Go官方工具 链安装目录下的bin子目录路径必须配置在PATH环境变量中。 链安装目录下的bin子目录路径必须配置在PATH环境变量中。 当使用安装程序 安装Go官方工具链时，安装程序很可能已经自动地将此配置好了。 Go官方工具链近来的版本均支持一个称为Go模块（Go modules）的特性，用来 管理项目依赖。 此特性在版本1.11中被试验性地引入并从版本1.16开始被默认 支持。 我们应该了解一个环境变量：GOPATH。 此环境变量的默认值为当前用户的 HOME目录下的名为go文件夹对应的目录路径。

多。 gc编译器是Go官方工具链中一个组件。 Go官方工具链的使用将在下一篇文章中介 绍。 Go官方工具链1.0发布于2012年三月。 Go语言规范的最新版本和Go官方工具链 的最新版本总是保持一致。 每年Go官方工具链发行两个主版本。 自从Go语言正式发布后，Go的语法变化很小。 但是标准编译器gc却在不断地改 进。 使用早期的gc编译的程序在运行的时候在每次垃圾回收的结尾常常会有明显 我们也可以使用工具[GoTV](https://go101.org/apps-and-libs/gotv.html)来安装 多个Go工具链版本，并方便和谐地使用它们。 Go官方工具链的版本和其所支持的最高Go语言版本是一致的。 比如，Go官方工具链 1.21.x版本支持从1.0到1.21的所有Go语言版本。 为了从任意目录运行Go官方工具链中工具命令（通过go命令）， Go官方工具链安 装目录下的bin子目录路径必须配置在PATH环境变量中。 装目录下的bin子目录路径必须配置在PATH环境变量中。 当使用安装程序安装Go 官方工具链时，安装程序很可能已经自动地将此配置好了。 Go官方工具链近来的版本均支持一个称为Go模块（Go modules）的特性，用来管理 项目依赖。 此特性在版本1.11中被试验性地引入并从版本1.16开始被默认支持。 我们应该了解一个环境变量：GOPATH。 此环境变量的默认值为当前用户的HOME目 录下的名为go文件夹对应的目录路径。

第三方工具安装：目前有很多方便的第三方软件包工具，例如Ubuntu的apt-get、Mac的homebrew等。这种安 装方式适合那些熟悉相应系统的用户。 最后，如果你想在同一个系统中安装多个版本的Go，你可以参考第三方工具GVM，这是目前在这方面做得最好的工 具，除非你知道怎么处理。 Go源码安装 Go源码安装 在Go的源代码中，有些部分是用Plan 9 C和AT&T汇编写的，因此 install gcc libc6-dev来安装编译工具。 在Windows系统中，你需要安装MinGW，然后通过MinGW安装gcc，并设置相应的环境变量。 Go使用Mercurial进行版本管理，首先你必须安装了Mercurial，然后才能下载。假设你已经安装好Mercurial，执行 如下代码： 假设已经位于Go的安装目录 $GO_INSTALL_DIR下 hg clone -u 系统类 型”一行中，若显示“x64-based PC”，即为64位系统；若显示“X86-based PC”，则为32位系统。 Mac系统用户建议直接使用64位的，因为Go所支持的Mac OS X版本已经不支持纯32位处理器了。 8 Linux系统用户可通过在Terminal中执行命令uname -a来查看系统信息： 64位系统显示 <一段描述> x86_64 x86_64 x86_64

为什么定位慢？-- 分布式错误 TraceId 分布式信息 错误尽早失败 串联信息 A B C A B V1版本 V2版本 配置错了，C的连接地址 • b服务记录了错误日志，但仍然启动b服务，a服务用了新版本的b服务。 • b服务停止启动，并记录错误日志，a服务用了老版本的b服务。 怎么办？ 这两种处理错误方式，你觉得哪种是对的？ 为什么定位慢？-- 分布式错误 TraceId 方法二，b服务 Fail Fast • b服务在初始化的时候，发现了b服务连接不上c服务，停止启动 • 最后一行可以看到报错信息，业务方可以立刻查看到核心错误 • 因为没有启动成功，不会更新b服务版本 • a服务不受影响，不影响线上功能 为什么定位慢？-- 分布式错误 发现核心错误后，应该让系统直接Panic。 • 必要的错误信息，让我们知道是在哪个地方报错，哪个微服务有问题。 • 错误信息高亮，显示红色让错误更加明显。 为什么恢复慢？-- 错误手册 自动化 经验 识别 • 自己写文档，代码和文档不一致 • 有错误码找不到代码对应地方 • 有错误码不知道是哪个版本的代码 • 错误码在代码里还有没有使用，错误码越变越多， • 错误码腐化，没用的错误码应该随版本下线 • 错误码的 SOP，国际化问题 相关链接 各种组件实现调试和高亮信息 https://github.com/gotomicro/ego