在 Debian 中管理 Golang 包的标准做法
在 Debian 上，Go 的依赖管理以官方内置的 Go Modules 为主；系统自带的 APT 仅用于安装 Go 工具链本身。Go Modules 自 Go 1.11 引入，并在 Go 1.13+ 默认启用，推荐在现代项目中使用。APT 安装的 Go 版本通常较旧，如需新版本或多版本共存，可考虑手动安装官方二进制或使用版本管理工具（如 goenv）。
安装与准备
- 使用 APT 安装 Go（便捷、集成好，但版本可能偏旧）：
- 更新索引并安装：sudo apt update && sudo apt install golang-go
- 验证安装：go version
- 常见可执行文件与库路径：/usr/bin/go、/usr/lib/go（Debian 打包的 GOROOT 通常为 /usr/lib/go）
- 若需最新版本或多版本管理（可选）：
- 手动安装官方二进制至 /usr/local 或用户目录，并配置 PATH（例如：export PATH=$PATH:/usr/local/go/bin）
- 使用版本管理工具（如 goenv）进行全局/项目级版本切换
- 现代 Go 模块项目通常无需显式设置 GOPATH；如确需设置，可仅设置 GOPATH=$HOME/go 并将 $GOPATH/bin 加入 PATH（可选）。
Go Modules 常用操作
- 初始化模块：go mod init （例如：github.com/yourname/project）
- 添加/升级依赖：
- 导入代码后直接构建/运行会自动写入 go.mod
- 手动获取：go get ；升级到最新：go get -u（或指定版本：go get pkg@v1.2.3）
- 同步依赖：go mod tidy（补齐缺失、移除未使用）
- 本地供应商模式：go mod vendor（将所有依赖复制到 vendor/）
- 查看依赖图：go mod graph
- 校验依赖一致性：go mod verify
- 清理模块缓存：go clean -modcache
- 常用环境变量（按需设置）：
- GO111MODULE=on（Go 1.11/1.12 可显式开启模块模式）
- GOPROXY=https://goproxy.cn,direct（国内常用代理；Go 1.13+ 可直接 go env -w 设置）
实用示例
- 新建并初始化项目：
- mkdir myapp && cd myapp
- go mod init github.com/yourname/myapp
- 添加依赖（例如 Gin）：
- go get github.com/gin-gonic/gin
- 构建与运行：
- go build
- ./myapp
- 或直接运行：go run main.go
- 整理依赖：
- 需要离线/锁定依赖时：
- go mod vendor
- 构建/运行启用 vendor 模式：go build -mod=vendor 或设置环境变量 GOFLAGS=-mod=vendor
常见问题与建议
- APT 安装的 Go 版本较旧：如需新特性或特定版本，优先手动安装官方二进制或使用 goenv 管理多版本。
- 国内网络拉取依赖慢：设置 GOPROXY=https://goproxy.cn,direct 提升下载速度与成功率。
- 依赖冲突/校验失败：执行 go mod tidy、go clean -modcache，必要时使用 replace 指向可访问的 fork 或版本。
- vendor 使用场景：日常开发不建议提交 vendor；在 CI/CD 或受限网络环境可考虑使用 vendor 以提升一致性与可重复性。
