本文旨在详细指导如何将golang项目中的包和可执行命令规范地发布到github，以便其他开发者可以通过`go get`命令轻松获取并导入使用。我们将重点阐述go语言项目结构中，如何为独立的包和命令创建git仓库，并强调`gopath`工作区与git仓库之间的区别，以及为何不应将`bin`和`pkg`等构建产物推送到github。
理解Golang工作区与Git仓库
在深入发布流程之前，理解Golang的GOPATH工作区概念至关重要。一个典型的GOPATH工作区包含bin、pkg和src三个目录：
- bin/: 存放编译生成的可执行文件。
- pkg/: 存放编译生成的包归档文件（.a文件），是平台和架构相关的。
- src/: 存放Go语言的源代码文件，通常按照导入路径的结构组织。
需要明确的是，当我们将Go代码发布到GitHub时，通常只涉及src目录下的源代码。bin和pkg目录中的内容是本地构建的产物，不应被推送到版本控制系统，因为它们是平台特定的且可以由源代码重新生成。一个GOPATH工作区可以包含多个独立的Git仓库，每个仓库对应一个可导入的包或可执行命令。
发布独立的Go语言包到GitHub
假设您有一个名为newmath的Go语言包，其源代码位于$GOPATH/src/github.com/username/newmath/sqrt.go。要将其发布到GitHub，使其可以被其他项目导入，您需要为该包创建一个独立的Git仓库。
以下是详细步骤：
立即学习“go语言免费学习笔记（深入）”；
-
创建包目录并初始化Git仓库： 首先，在您的GOPATH/src目录下，按照GitHub的路径结构创建包的目录，并在此目录下初始化Git仓库。
$ mkdir -p $GOPATH/src/github.com/username/newmath $ cd $GOPATH/src/github.com/username/newmath $ git init
请将username替换为您的GitHub用户名。
-
编写包源代码： 在该目录下创建您的Go包源代码文件，例如sqrt.go。
$ touch sqrt.go # 使用文本编辑器（如gvim）编辑sqrt.go，添加包代码 $ gvim sqrt.go
sqrt.go示例内容：
package newmath func Sqrt(x float664) float64 { return x * x // 示例函数 } -
提交并推送到GitHub： 将源代码添加到Git仓库，提交并推送到您在GitHub上创建的同名仓库（例如github.com/username/newmath）。
$ git add sqrt.go $ git commit -m 'Initial commit of newmath package' $ git remote add origin https://github.com/username/newmath.git $ git push -u origin master
请确保您已在GitHub上创建了对应的空仓库。
-
其他项目如何使用： 一旦包发布成功，其他开发者就可以通过go get命令获取您的包，并在其代码中导入使用：
$ go get github.com/username/newmath
在Go源代码中：
import "github.com/username/newmath" func main() { // 使用 newmath 包 result := newmath.Sqrt(4.0) // ... }go get命令会自动将源代码下载到调用者的$GOPATH/src/github.com/username/newmath目录下。
发布独立的Go语言可执行命令到GitHub
如果您有一个名为hello的可执行命令，其源代码位于$GOPATH/src/github.com/username/hello/hello.go，并且它与newmath包没有紧密关联，那么它也应该拥有自己的独立Git仓库。
发布步骤与发布包类似：
-
创建命令目录并初始化Git仓库：
$ mkdir -p $GOPATH/src/github.com/username/hello $ cd $GOPATH/src/github.com/username/hello $ git init
-
编写命令源代码： 创建并编辑hello.go文件。
$ touch hello.go $ gvim hello.go
hello.go示例内容：
package main import "fmt" func main() { fmt.Println("Hello, Go!") } -
提交并推送到GitHub：
$ git add hello.go $ git commit -m 'Initial commit of hello command' $ git remote add origin https://github.com/username/hello.git $ git push -u origin master
-
其他用户如何获取和安装： 其他开发者可以通过以下命令获取并安装您的可执行命令：
$ go get github.com/username/hello $ go install github.com/username/hello
go get会下载源代码，go install则会编译源代码并将其可执行文件放置在调用者的$GOPATH/bin目录下。之后，用户就可以直接运行hello命令。
重要注意事项与最佳实践
工作区与仓库的粒度： 一个GOPATH工作区通常包含多个Git仓库。每个可导入的Go包或独立的Go命令都应拥有自己的Git仓库。将整个GOPATH工作区（包括bin和pkg）作为一个Git仓库推送到GitHub是不推荐的，因为它包含了本地构建的产物和可能不相关的多个项目。
-
bin和pkg目录的排除：
- $GOPATH/pkg目录包含编译后的包归档文件（.a），它们是平台和架构特定的。发布这些文件到GitHub毫无意义，因为它们可以在任何目标系统上由源代码重新生成。
- $GOPATH/bin目录包含编译后的可执行文件。虽然在某些特殊情况下可能有人选择发布预编译的二进制文件，但这通常是不必要的，因为用户可以通过go install从源代码自行构建。发布源代码使得二进制文件更具可信度，且能适应不同的操作系统和架构。
go get的机制：go get命令的核心功能是根据导入路径从版本控制系统（如Git）获取源代码，并将其放置在$GOPATH/src下对应的位置。因此，确保您的GitHub仓库路径与Go的导入路径（例如github.com/username/repo_name）完全匹配是关键。
单一仓库原则： 尽管存在将多个不相关包或命令放入一个大型Git仓库的做法，但Go社区普遍倾向于“一个仓库一个主要包/命令”的原则。这使得版本控制、依赖管理和项目维护更加清晰和独立。
总结
将Golang项目发布到GitHub的核心在于理解GOPATH工作区与Git仓库之间的区别，并遵循“为每个独立的包或可执行命令创建单独的Git仓库”的原则。通过这种方式，您可以确保其他开发者能够通过标准的go get命令轻松地获取、导入和使用您的Go代码，同时避免将本地构建产物纳入版本控制，保持项目的整洁和高效。
