详解如何使用Bazel构建Golang程序

下面是详细讲解如何使用Bazel构建Golang程序的完整攻略。

什么是Bazel

Bazel 是 Google 开发的一种构建工具，它可以用于构建各种编程语言的应用程序，包括 Golang。Bazel 有以下特点：

• 可以处理非常大的代码库和构建目标。
• 支持多种语言和平台的构建。
• 支持自定义构建规则，并且可以调用外部工具。
• 有自己的缓存机制，可以显著提高重新构建时的速度。

如何使用Bazel构建Golang程序

安装Bazel

首先，需要安装 Bazel。可以从官方网站下载适合自己操作系统的 Bazel 安装包。

创建Golang项目

假定我们要创建一个名为 hello 的 Golang 项目。首先，在一个空的目录下创建一个 WORKSPACE 文件。这个文件声明了项目的元数据，并指定了 Bazel 相关的依赖库。一个简单的 WORKSPACE 文件如下：

# WORKSPACE

workspace(name = "hello")

load("@bazel_golang//go:deps.bzl", "go_register_toolchains", "go_repository")

go_register_toolchains()

go_repository(
    name = "com_github_google_uuid",
    importpath = "github.com/google/uuid",
    commit = "c4e0bc6c40c87d9adca498de124d9fdfc2d4c3da",
)

在此文件中，我们注册了一个Golang的工具链，导入了依赖库bazel_golang，并添加了一个github.com/google/uuid的依赖库。

接下来，在该目录下创建一个名为 hello.go 的文件，代码如下：

// hello.go

package main

import "fmt"

func main() {
    fmt.Println("Hello, world!")
}

添加 BUILD 文件

接下来，在项目根目录下创建一个文件 BUILD.bazel 文件。该文件包含关于如何构建所有包及其依赖关系的规则。我们的 BUILD.bazel 文件如下：

# BUILD.bazel

load("@bazel_golang//go:def.bzl", "go_binary")

go_binary(
    name = "hello",
    srcs = ["hello.go"],
    deps = ["@com_github_google_uuid//:uuid"],
)

该文件定义了一个 go_binary 目标，指定了项目的名称，指定要编译的源文件，以及依赖库。

编译项目

通过下面的命令将项目编译为二进制文件：

$ bazel build //:hello

成功编译后，如果一切顺利，就可以在 bazel-bin 目录下找到编译出来的可执行文件 hello。

运行项目

通过下面的命令运行项目：

$ bazel run //:hello

输出应该会显示 "Hello, world!"。

示例

示例1：在项目中使用Golang依赖库

在上面的示例中，我们在 WORKSPACE 文件中导入了一个依赖库 github.com/google/uuid。现在我们来使用这个依赖库。假设我们要修改 hello.go 文件，使其使用 uuid 库中的 New 函数来生成一个唯一的 UUID，代码如下：

// hello.go

package main

import (
    "fmt"
    "github.com/google/uuid"
)

func main() {
    u := uuid.New()
    fmt.Printf("UUID: %s", u.String())
}

修改后，我们需要在 BUILD.bazel 文件中添加 uuid 作为一个依赖关系：

# BUILD.bazel

load("@bazel_golang//go:def.bzl", "go_binary")

go_binary(
    name = "hello",
    srcs = ["hello.go"],
    deps = [
        "@com_github_google_uuid//:uuid",
        "@com_github_spf13_cobra//:cobra",
    ],
)

注意：在这里，我们还添加另一个依赖库 github.com/spf13/cobra，以使得 hello 命令支持更多的命令行选项。

然后，编译并运行项目：

$ bazel build //:hello
$ bazel run //:hello

示例2：使用第三方依赖库

假设，我们还想使用第三方的依赖库。在这里，我们将使用 github.com/go-resty/resty 库。首先，在 WORKSPACE 文件中添加库的声明：

# WORKSPACE

workspace(name = "hello")

load("@bazel_golang//go:deps.bzl", "go_register_toolchains", "go_repository")

go_register_toolchains()

go_repository(
    name = "com_github_google_uuid",
    importpath = "github.com/google/uuid",
    commit = "c4e0bc6c40c87d9adca498de124d9fdfc2d4c3da",
)

go_repository(
    name = "com_github_go_resty_resty",
    importpath = "github.com/go-resty/resty/v2",
    tag = "v2.6.0",
)

然后，我们可以修改 hello.go 文件来使用 resty 库：

// hello.go

package main

import (
    "fmt"
    "github.com/go-resty/resty/v2"
)

func main() {
    client := resty.New()
    url := "https://api.github.com/repos/googlecodelabs/cloud-run-hello-world/releases/latest"
    resp, _ := client.R().Get(url)

    fmt.Printf("Response: %s", resp.String())
}

最后，我们需要将 resty 库添加到 BUILD.bazel 文件中：

# BUILD.bazel

load("@bazel_golang//go:def.bzl", "go_binary")

go_binary(
    name = "hello",
    srcs = ["hello.go"],
    deps = [
        "@com_github_google_uuid//:uuid",
        "@com_github_go_resty_resty//:v2",
    ],
)

编译并运行项目：

$ bazel build //:hello
$ bazel run //:hello

以上就是使用 Bazel 构建 Golang 项目的详细攻略。