Go程序的结构

1、Go 的命名规则

Go 源文件总是用全小写字母形式的短小单词命名，并且以.go 扩展名结尾。

如果要在源文件的名字中使用多个单词，我们通常直接是将多个单词连接起来作为源文件名，而不是使用其他分隔符，比如下划线。也就是说，我们通常使用 helloworld.go 作为文件名而不是 hello_world.go。

2、Go常见约定

main 包在 Go 中是一个特殊的包，整个 Go 程序中仅允许存在一个名为 main 的包。

作为 Go 开发人员，请在提交你的代码前使用 Gofmt 格式化你的 Go 源码。

在 Go 语言中，只有首字母为大写的标识符才是导出的（Exported），才能对包外的代码可见；如果首字母是小写的，那么就说明这个标识符。

3、Go 语言中程序是怎么编译的？

可以使用go build编译，一个简单的示例如下，假设我们的文件名为：main.go：

$ go build main.go

这个步骤与 gcc 或 clang 编译十分相似。一旦编译成功，我们就会获得一个二进制的可执行文件。

如果你之前更熟悉某种类似于 Ruby、Python 或 JavaScript 之类的动态语言，你可能还不太习惯在运行之前需要先进行编译的情况。

Go 是一种编译型语言，这意味着只有你编译完 Go 程序之后，才可以将生成的可执行文件交付于其他人，并运行在没有安装 Go 的环境中。

而如果你交付给其他人的是一份.rb、.py 或.js 的动态语言的源文件，那么他们的目标环境中就必须要拥有对应的 Ruby、Python 或 JavaScript 实现才能解释执行这些源文件。

当然，Go 也借鉴了动态语言的一些对开发者体验较好的特性，比如基于源码文件的直接执行，Go 提供了 run 命令可以直接运行 Go 源码文件，比如我们也可以使用下面命令直接基于 main.go 运行：

$go run main.go
hello, world

当然像 go run 这类命令更多用于开发调试阶段，真正的交付成果还是需要使用 go build 命令构建的。

实际盛昌环境中，Go 程序的编译往往不会像我们前面，基于单个 Go 源文件构建类似“hello，world”这样的示例程序那么简单。越贴近真实的生产环境，也就意味着项目规模越大、协同人员越多，项目的依赖和依赖的版本都会变得复杂。

4、复杂项目下 Go 程序的编译是怎样的？

稍微大一点的项目都会依赖第三方库，而这些依赖库的安装和管理其实还挺复杂的。这里直接开门见山吧，是时候让 Go module 登场了！

Go module 构建模式是在 Go 1.11 版本正式引入的，为的是彻底解决 Go 项目复杂版本依赖的问题，在 Go 1.16 版本中，Go module 已经成为了 Go 默认的包依赖管理机制和 Go 源码构建机制。

Go Module 的核心是一个名为 go.mod 的文件，在这个文件中存储了这个 module 对第三方依赖的全部信息。

可以使用go mod init为项目生成go.mod文件，示例如下：

$go mod init github.com/bigwhite/hellomodule
go: creating new go.mod: module github.com/bigwhite/hellomodule
go: to add module requirements and sums:
  go mod tidy

go.mod 中没有这依赖包的版本信息，我们需要按提示手工添加信息到 go.mod 中。这个时候，除了按提示手动添加外，我们也可以使用 go mod tidy 命令，让 Go 工具自动添加第三方依赖包：

$go build main.go
main.go:4:2: no required module provides package github.com/valyala/fasthttp; to add it:
  go get github.com/valyala/fasthttp
main.go:5:2: no required module provides package go.uber.org/zap; to add it:
  go get go.uber.org/zap

5、小结

• Go 包是 Go 语言的基本组成单元。一个 Go 程序就是一组包的集合，所有 Go 代码都位于包中；
• Go 源码可以导入其他 Go 包，并使用其中的导出语法元素，包括类型、变量、函数、方法等，而且，main 函数是整个 Go 应用的入口函数；
• Go 源码需要先编译，再分发和运行。如果是单 Go 源文件的情况，我们可以直接使用 go build 命令 +Go 源文件名的方式编译。不过，对于复杂的 Go 项目，我们需要在 Go Module 的帮助下完成项目的构建。

6、常见问题

1、很多教程都用github.com... 做例子， 你说的是”路径“，路径不应该"D:\goprojects\hellomodule" 吗？我自己自定义一个任意的名字也可以正常运行？我感觉很奇怪，为什么很多人用github.com/...做module呢?

答：使用github.com/...作为module path是因为多数实用级module多是上传到github上的。用这种示例便于后续与真实生产接驳。但对于本地开发使用的简单示例程序而言，你说的没错。module path可以任意起，比如：module demo1也是ok的。

2、go mod tidy 命令后，下载的包在哪？在Go语言安装路径的src文件夹中？还是在哪?

答：go mod tidy下载的第三方包一般在$GOPATH/pkg/mod下面。如果没有设置GOPATH环境变量，其默认值为你的home路径下的go文件夹。这样第三方包就在go文件夹的pkg/mod下面。

3、有了 Go Module 之后， GoPath 还有存在的必要么？

答：（2021.10.20）go官方有移除gopath的打算。目前这个时间点，学习go基本不需要了解太多gopath了。go module已经是go官方标准包依赖管理和构建模式了，所以从go入门开始就建议直接使用go module。gopath模式可以简单了解一下，然后忽略掉就好了。