如果项目中包含了多个main入口文件，比如👇
$ tree ./github.com/voidint/test
./github.com/voidint/test
├── cmd
│ ├── apiserver
│ │ └── main.go
│ ├── dbtool
│ │ └── main.go
│ └── init
│ └── main.go
└── gbb.json
4 directories, 4 files对于这样子目录结构，该怎么去编译这些个程序？假设使用原生的go build/install工具，也许会这么做：
-
输入完整的路径编译
$ go install github.com/voidint/test/cmd/apiserver $ go install github.com/voidint/test/cmd/dbtool $ go install github.com/voidint/test/cmd/init
-
逐个切换工作目录后执行
go build/install$ cd github.com/voidint/test/cmd/apiserver && go install && cd - $ cd github.com/voidint/test/cmd/dbtool && go install && cd - $ cd github.com/voidint/test/cmd/init && go install && cd -
操作完之后是否会觉得很繁琐？如果一天需要编译这个项目几十次，那会相当低效。可惜，目前go build/install好像并不支持在项目根目录下编译子孙目录中所有的main入口文件。
昨天跑得好好的程序突然出了问题，查看它的版本号，机器冷冰冰地告诉你👇
$ xxx --version
xxx version 1.0.12如果没有详细的发布记录，那么此时的你一定是崩溃的。因为实在不知道这个1.0.12到底是什么时候编译的，更加不知道是从哪份源代码编译而来，想要找出其中的bug，难度大了不少。
那么，同样的场景下，机器告诉你的信息是这样，那debug是否容易多了呢？！
$ xxx --version
xxx version 1.0.12
date: 2016-12-18T15:37:09+08:00
commit: db8b606cfc2b24a24e2e09acac24a52c47b68401如果以上的场景你也似曾相识，那么也许gbb就能帮到你，耐心往下👀吧。
根据以上的场景描述，可以简单地将主要特性归纳为如下几条：
- 一键编译项目目录下所有
go package。 - 支持编译时自动“嵌入”信息到二进制可执行文件。典型的如嵌入
编译时间和源代码Commit信息到二进制可执行文件的版本信息当中。 - 首次运行会在项目根目录生成配置文件
gbb.json，今后编译操作所需的信息都从该文件读取，无需用户干预。
-
源代码安装
-
拉取源代码
$ go get -u -v github.com/voidint/gbb
-
编译（默认情况下
go get就会编译安装）$ cd $GOPATH/src/github.com/voidint/gbb && go install -
将可执行文件
gbb放置到PATH环境变量内 -
执行
which gbb确认是否安装成功 -
若
gbb重名，那么建议设置别名，比如alias gbb=gbb2。
-
-
二进制安装
gbb是自举的，换句话说，使用以上步骤安装的gbb可执行二进制文件是可以编译gbb源代码的。类似👇
$ cd $GOPATH/src/github.com/voidint/gbb && gbb --debug
==> go build -ldflags '-X "github.com/voidint/gbb/build.Date=2016-12-17T17:00:04+08:00" -X "github.com/voidint/gbb/build.Commit=db8b606cfc2b24a24e2e09acac24a52c47b68401"'
$ ls -l ./gbb
-rwxr-xr-x 1 voidint staff 4277032 12 17 17:00 ./gbb可以看到当前目录下已经多了一个可执行二进制文件。没错，这个./gbb就是使用已经安装的gbb编译源代码后的产物。
怎么使用gbb来代替go build/install或者gb来完成日常的代码编译工作呢？简单，跟着下面的步骤尝试一下，立马就学会了。
既然需要演示使用方法，必然就需要有个go项目。下面以gbb项目为例来展开。
为了从零开始我们的演示，请先把源代码目录下的gbb.json文件删除。gbb.json的作用以及文件内容的含义暂且不表，下文自然会提到。
$ rm -f gbb.json
首先，明确下使用gbb工具能干什么事？
如场景一所描述的那样，如果日常都是使用go build/install去应对编译工作，并且也不需要在二进制可执行文件中“嵌入”什么信息，那么，请跳过下面的step0，直接阅读step1。
如果对“嵌入”编译时间、Commit这类信息到二进制可执行文件中有一定兴趣，那么建议从头至尾通读一遍吧。
为了在版本信息中显示编译时间和commit号这两个关键信息（并不限于这两个信息），需要先定义两个可导出变量。
package build
var (
Date string
Commit string
)
然后，设法在功能代码中用上这两个变量。类似👇。
package cmd
import (
"fmt"
"github.com/spf13/cobra"
"github.com/voidint/gbb/build"
)
var (
// Version 版本号
Version = "0.1.0"
)
var versionCmd = &cobra.Command{
Use: "version",
Short: "Print version information",
Long: ``,
Run: func(cmd *cobra.Command, args []string) {
fmt.Printf("gbb version %s\n", Version)
if build.Date != "" {
fmt.Printf("date: %s\n", build.Date)
}
if build.Commit != "" {
fmt.Printf("commit: %s\n", build.Commit)
}
},
}
func init() {
RootCmd.AddCommand(versionCmd)
}在项目根目录执行gbb init，按照gbb init的提示，逐步填写完信息并最终生成gbb.json文件。关于gbb.json，请参见下文的详细说明。
如果是场景一的使用场景，那么只需要填写tool（实际调用的编译工具）后按要求终止流程即可。
$ gbb init
This utility will walk you through creating a gbb.json file.
It only covers the most common items, and tries to guess sensible defaults.
Press ^C at any time to quit.
tool: (go install) go build
Do you want to continue?[y/n] n
About to write to /Users/voidint/cloud/workspace/go/lib/src/github.com/voidint/gbb/gbb.json:
{
"version": "0.6.1",
"tool": "go build"
}
Is this ok?[y/n] y如果满足场景二所描述的情况，那么还需要继续信息搜集流程。
$ gbb init
This utility will walk you through creating a gbb.json file.
It only covers the most common items, and tries to guess sensible defaults.
Press ^C at any time to quit.
tool: (go install) go build
Do you want to continue?[y/n] y
importpath: (main) github.com/voidint/gbb/build
variable: Date
value: {{.Date}}
Do you want to continue?[y/n] y
variable: Commit
value: {{.GitCommit}}
Do you want to continue?[y/n] n
About to write to /Users/voidint/cloud/workspace/go/lib/src/github.com/voidint/gbb/gbb.json:
{
"version": "0.6.1",
"tool": "go build",
"importpath": "github.com/voidint/gbb/build",
"variables": [
{
"variable": "Date",
"value": "{{.Date}}"
},
{
"variable": "Commit",
"value": "{{.GitCommit}}"
}
]
}
Is this ok?[y/n] y在项目根目录执行gbb --debug，gbb会读取当前目录下的gbb.json并执行编译。若gbb.json文件不存在，则gbb init会被自动调用，以用于创建该文件。
$ gbb --debug
==> go build -ldflags '-X "github.com/voidint/gbb/build.Date=2020-05-03T16:11:47+08:00" -X "github.com/voidint/gbb/build.Commit=471876228386f1f4374fc39e675a54be4b7a3715"'
编译完后在目录下（由于gbb.json中的tool配置的是go build，若换成go install，那可执行文件将被放置在GOPATH的bin目录下）多出一个编译后的二进制文件。试着输出版本信息，看看是否实现我们设定的目标了。
$ ./gbb version
gbb version 0.6.1
date: 2020-05-03T16:11:47+08:00
commit: 471876228386f1f4374fc39e675a54be4b7a3715
😊
gbb.json可以认为是gbb工具的配置文件，通过gbb init自动创建（感谢npm init）。通常它的格式是这样：
{
"version": "0.6.1",
"tool": "go build -v -ldflags='-s -w' -gcflags='-N -l'",
"importpath": "github.com/voidint/gbb/build",
"variables": [
{
"variable": "Date",
"value": "{{.Date}}"
},
{
"variable": "Commit",
"value": "{{.GitCommit}}"
},
{
"variable": "Branch",
"value": "$(git symbolic-ref --short -q HEAD)"
}
]
}version: gbb版本号。gbb根据自身版本号自动写入gbb.json。tool: gbb实际所调用的编译工具，支持附带编译工具的编译选项。已支持编译工具包括：go build、go install、gb build。importpath: 包导入路径，也就是Date、Commit这类变量所在包的导入路径，如github.com/voidint/gbb/build。variables: 变量列表。列表中的每个元素都包含variable和value两个属性。variable变量名，比如Date。value变量表达式- 内置变量表达式
{{.Date}}: 输出RFC3339格式的系统时间。{{.GitCommit}}: 输出当前分支最近一次git commit hash字符串。
- 命令形式的变量表达式
- 以
$(开头，)结尾，中间的字符串内容会被当做命令被执行。如表达式$(date)，date命令的输出将会作为变量表达式最终的求值结果。在非windows系统下，会调用默认的shell对变量表达式求值，如/bin/bash -c "git symbolic-ref --short -q HEAD"。
- 以
- 内置变量表达式
- 修订copyright
- Add feature: 添加
clean子命令。#26 - Add feature: 添加
--all全局选项。#25 - Add feature: 添加
UNIX-style命令行选项-D和-c。#27 - Add feature: 将版权信息加入到help输出当中。#30
- Add feature: 编译完成后输出总耗时。#31
- Modify feature: 对于非内置的表达式求值，将表达式本身原样返回作为求值结果。#32
- Modify feature: *NIX系统下通过shell对命令形式的变量表达式进行求值。#34
- Add feature: 支持合并
-ldflags选项的值。#23 - Fixbug:
gbb.json中的version值不满足xx.xx.xx格式情况下，提示语的末尾出现意外的%。#20 - Fixbug: 若
gbb.json的tool属性值中包含空格，则无法正常编译。#24 - Fixbug:
gbb init无法获取键盘输入的空格内容。#1 - 提升单元测试用例覆盖率
- 支持编译当前目录下所有
go package，不再仅限于编译main package。#10 gbb.json中的配置项package重命名为importpath。#9- 新增命令行选项
--config用于自定义配置文件路径。#16 - 切换目录并编译后重新切换回源目录。#17
- 当
gbb.json的版本号高于gbb程序版本号时给出程序升级提醒。#19
gbb.json中的配置项——package和variables由必选项改为可选项。其中，在variables选项为空的情况下，实际在调用编译工具编译时不再加上形如-ldflags '-X "xxx.yyy=zzz"'的参数。#8- 若程序版本号与
gbb.json中的version值不一致，就会强制重新生成gbb.json文件。
- 支持通过
gbb init初始化配置信息并生成gbb.json配置文件。 - 支持在项目根目录下，一键编译所有入口源代码文件，并生成一个或者多个可执行二进制文件。#4
- 支持调用
gb或者go build/install，并为编译生成的可执行文件提供丰富的版本信息中，包括但不限于：编译时间、源代码版本控制commit等。