在 Ubuntu 上编译 Golang 库文件

想在 Ubuntu 上把 Go 代码打包成可复用的库文件？这事儿其实没想象中那么复杂。只要环境搭对了，步骤走顺了，整个过程可以说是相当清晰。下面就来详细拆解一下每一步该怎么操作。

1. 安装 Go 语言环境

万事开头难，但第一步其实最简单。如果系统里还没有 Go 环境，直接去官网 https://golang.org/dl/ 下载对应 Ubuntu 的安装包就行。跟着官方指引安装，基础环境就搭建好了。

2. 配置 Go 环境变量

环境装好只是开始，关键还得让系统知道去哪找 Go 的命令工具。打开终端，执行下面这两条命令，把 Go 的二进制文件路径加到系统的 PATH 里：

echo "export PATH=$PATH:$HOME/go/bin" >> ~/.profile
source ~/.profile

这样一来，后续在任何位置就都能直接调用 go 命令了。

3. 创建库文件目录

Go 对代码的存放路径有它自己的“规矩”。建议在 Go 的工作空间内创建一个专门的目录来存放你的库。执行以下命令：

mkdir -p $HOME/go/src/mylibrary
cd $HOME/go/src/mylibrary

这里的 mylibrary 可以替换成你实际的库名。这个目录就是你的“库项目”大本营。

4. 编写 Go 库代码

接下来就是核心环节——写代码。进入刚才创建的目录，新建一个 .go 文件，比如 mylibrary.go。记住，库代码的关键在于“导出”，只有首字母大写的函数、类型或变量，才能被外部使用。

举个最简单的例子，我们创建一个打招呼的库：

package mylibrary

import "fmt"

func Hello(name string) {
    fmt.Printf("Hello, %s!\n", name)
}

看，这个 Hello 函数就是对外提供的“服务”。

5. 编译库文件

代码写好，就可以编译了。在当前库目录下，运行一个简单的命令：

go build

命令执行成功后，你会发现在目录里生成了一个名为 mylibrary.a 的文件。这个 .a 文件就是编译好的静态库，也就是我们最终要的成果。

6. 使用你的库文件

库编译出来，终究是要给别人用的。这里有个常见的做法：为了让其他项目能方便地引用，可以把库文件（或整个模块）移到一个公共位置，比如 $HOME/go/pkg/mod/ 下。

然后，在你的另一个 Go 项目中，通过以下命令添加依赖：

go get $HOME/go/pkg/mod/mylibrary

这行命令会在你项目的 go.mod 文件里自动添加对 mylibrary 的引用。之后，就能像使用标准库一样导入它了：

package main

import (
    "mylibrary"
)

func main() {
    mylibrary.Hello("World")
}

7. 编译并运行你的项目

最后一步，验证成果。在你的主项目目录下，运行 go build 来编译整个项目。编译成功后，直接执行生成的二进制文件：

./

如果终端上顺利打印出了 “Hello, World!”，那么恭喜你，从编写、编译到调用 Go 库的完整流程，你已经全部走通了。

整个过程梳理下来，其实核心就是遵循 Go 的路径约定，理解包的导出规则，然后用好 go build 和 go get 这两个关键命令。多操作几次，自然会得心应手。