用 pkg install 安装 Go 最快但版本滞后，通常慢1–2个minor版本；需用 pkg search ^go$ 查版本、go version 验证，并手动设 GOPATH；升级 major 版本需手动指定如 pkg install go-1.22。
用 pkg install 安装 Go 最快，但版本可能滞后
FreeBSD 的 pkg 仓库默认提供稳定版 Go，通常比最新发布版慢 1–2 个 minor 版本（比如系统里是 go-1.21.6，而官网已发 go-1.22.3）。如果你做日常开发、CI 构建或依赖特定语言特性（如 type alias 或 generic 的新语法糖），得确认版本是否够用。
实操建议：
- 运行
pkg search ^go$查当前可用版本，注意包名是go，不是golang - 安装后检查：
go version，路径通常是/usr/local/bin/go - 别漏设
GOPATH（即使 Go 1.16+ 默认使用$HOME/go，某些老项目或工具仍会读它） - 如果后续要升级，
pkg upgrade go可能跳过 major 升级（比如从 1.21 → 1.22），需手动pkg install go-1.22或等仓库同步
用 ports 编译安装 Go 能控版本，但耗时且易出错
Ports 树里的 lang/go 允许你指定 GO_VERSION（通过 make config 或环境变量），适合需要精确匹配 CI 环境、或必须用未进 pkg 仓库的 RC 版本的场景。但它不是“一键编译”，实际过程涉及源码下载、交叉编译 bootstrap、本地构建，失败点集中在网络和权限上。
常见错误现象：
-
fetch: Unable to fetch expected file go/src/cmd/compile/internal/ssa/gen.go：被墙或MASTER_SITE_GO配置失效 -
cannot find package "unsafe"：没先用系统自带 Go 构建 bootstrap（ports 要求先有可用go才能编译新版） - 编译卡在
runtime/cgo：缺少devel/gmake或lang/gcc未正确注册为默认CC
实操建议：
- 先确保已有可用 Go（哪怕旧版）：
pkg which go或which go - 进入
/usr/ports/lang/go，运行make config勾选DOCS和EXAMPLES（调试时有用），再make install clean - 若想换版本，改
Makefile中的GO_VERSION后必须make clean再重来，缓存不会自动失效
PATH 和 GOPATH 冲突是新手最常踩的坑
FreeBSD 上容易同时存在多个 Go：pkg 装的、ports 装的、甚至手动解压到 /opt/go 的。which go 返回的不一定是你刚装的那个；go env GOPATH 可能指向 /root/go（如果用 sudo make install 装 ports），导致 go get 下载的包对普通用户不可见。
实操建议：
- 统一用非 root 用户操作：ports 安装时加
sudo -u $USER make install，避免权限混杂 - 在
~/.profile或~/.zshrc显式设置：export PATH="/usr/local/bin:$PATH"（pkg）或export PATH="/usr/ports/lang/go/work/bin:$PATH"（ports 构建目录，仅临时调试） - 显式声明
GOPATH：export GOPATH="$HOME/go"，别依赖默认值——尤其当你用go mod但某些工具（如gopls）仍查GOPATH - 验证：新开 shell 后跑
go env GOROOT GOPATH GOBIN，三者路径不能互相嵌套（比如GOPATH不该在GOROOT下）
Go module proxy 和 vendor 在 FreeBSD 上基本无差别
FreeBSD 的 Go 安装和 Linux/macOS 一样走标准 go 二进制，所以 GOPROXY、GO111MODULE、go mod vendor 这些行为完全一致，不存在系统级兼容问题。唯一要注意的是：默认 GOPROXY 是 https://proxy.golang.org，国内访问可能超时，导致 go build 卡住。
实操建议：
- 国内用户直接设：
go env -w GOPROXY=https://goproxy.cn,direct - 不要在
/etc/make.conf或 portsmake config里动 proxy 相关选项——那是给 ports 构建自身用的，不影响运行时go命令 - 如果项目用了
vendor，记得go mod vendor后提交整个vendor/目录，FreeBSD 上go build -mod=vendor和其他系统表现一致
真正麻烦的从来不是装 Go，而是装完之后发现 go test 里调用的 cgo 代码链接不到 libc 的某个 symbol——那大概率是 CC 指向了 clang 但没传对 --sysroot，或者你用 ports 装的 Go 和系统头文件版本错位了。这种时候，别急着重装，先 go env CC CGO_ENABLED 看清楚当前配置再说。
