Debian系统Golang包管理技巧

Go语言的包管理，尤其是模块机制，如今已经是日常开发的基础设施了。如果你在Debian这类Linux发行版上工作，掌握好Go Modules的用法，能让依赖管理变得清爽很多。下面就从环境安装开始，把几个核心操作拆开来聊一聊。

1. 安装Go环境

要在Debian上玩转Go包管理，第一步自然是把Go装好。用系统包管理器是最省事的：

sudo apt update && sudo apt install golang-go

装完了？别忘了跑一下 go version，确认版本号出来了再继续——这一步算是个简单的“健康检查”。

2. 启用Go Modules（Go 1.13+默认开启）

Go Modules是官方推荐的依赖管理方案，从Go 1.11开始引入，到了1.13及以上版本，默认就开着。如果你还在用比较老的版本，需要手动打开环境变量：

export GO111MODULE=on

建议把这个命令加到 ~/.bashrc 或 ~/.profile 里，省得每次重新登录都要再敲一遍。

3. 初始化Go模块

项目根目录下执行下面这行，会生成一个 go.mod 文件——里面记录着模块名称、Go版本以及各种依赖信息：

go mod init 

这里的 一般就是项目的导入路径，比如 github.com/username/projectname。起个清晰点的名字，后续引用也方便。

4. 添加/更新依赖

• 添加依赖：当代码里引入了新包（比如 import "github.com/gin-gonic/gin"），然后运行程序，Go会自动下载依赖并更新 go.mod。当然你也可以手动触发：

  go get 

• 更新依赖：想把所有依赖都升到最新版？

  go get -u ./...

  只更新某个特定的包，比如 gin：

  go get -u github.com/gin-gonic/gin

• 指定版本：如果非要某个特定版本（比如 v1.7.4），在 go get 后面加个 @版本号 就行：

  go get github.com/gin-gonic/gin@v1.7.4

  或者直接手动改 go.mod 里的 require 语句。

5. 清理依赖

• 移除未使用的依赖：运行 go mod tidy，它会自动把 go.mod 和 go.sum 里那些代码里不引用的依赖删掉，保持依赖列表干干净净。
• 清理缓存：Go 会把下载的依赖包缓存到本地（默认在 $GOPATH/pkg/mod）。如果磁盘空间告急，可以执行：

  go clean -modcache

6. 查看依赖信息

• 查看所有依赖：用 go list 可以列出当前模块的所有直接和间接依赖：

  go list -m all

• 查看依赖关系图：想看清楚模块之间的依赖层级？

  go mod graph

  输出一个关系图，方便分析依赖结构。

7. 使用vendor目录（可选）

如果你希望把依赖包直接复制到项目本地（比如怕网络不通，或者要保证依赖版本绝对一致），可以执行：

go mod vendor

这会在项目根目录下生成一个 vendor 文件夹，里面装着所有依赖包。构建时加上 -mod=vendor 参数，就能强制使用本地 vendor 目录里的依赖：

go build -mod=vendor

8. 配置代理（中国大陆加速）

中国大陆的开发者访问官方模块仓库（比如 proxy.golang.org）往往慢得让人抓狂。建议换成国内代理，比如 goproxy.cn：

export GOPROXY=https://goproxy.cn,direct

或者用 go env 永久设置：

go env -w GOPROXY=https://goproxy.cn,direct

9. 管理多个Go版本（可选）

如果你需要同时用多个Go版本（比如测试兼容性），GVM（Go Version Manager）是个好东西。

• 安装GVM：

  bash < <(curl -s -S -L https://raw.githubusercontent.com/moovweb/gvm/master/binscripts/gvm-installer)

• 安装指定版本：

  gvm install go1.20.5

• 切换版本：

  gvm use go1.20.5

• 设置默认版本：

  gvm use go1.20.5 --default

这样就能在多个Go版本之间随意切换了，特别适合做跨版本测试的场景。