如何在 Ubuntu 上同时使用 go 和 godoc 命令-Golang-PHP中文网

如何在 Ubuntu 上同时使用 go 和 godoc 命令

在 ubuntu 中通过 apt 安装 golang 后缺少 godoc 命令，而单独安装 golang-go.tools 又导致 go 命令失效；本文提供安全、兼容的解决方案，推荐使用 go get 方式安装 godoc，并避免 apt 包冲突。

在 ubuntu 中通过 apt 安装 golang 后缺少 godoc 命令，而单独安装 golang-go.tools 又导致 go 命令失效；本文提供安全、兼容的解决方案，推荐使用 go get 方式安装 godoc，并避免 apt 包冲突。

Ubuntu 官方仓库中的 golang（即 golang-1.x 系列）与 golang-go.tools 包存在路径和二进制文件覆盖冲突：后者会安装自己的 go 二进制（常为旧版或精简版），覆盖 /usr/bin/go，从而导致原始 go 命令不可用或行为异常。因此，不建议混合使用 apt install golang 与 apt install golang-go.tools。

✅ 推荐方案：使用 go get 安装 godoc（适用于 Go 1.16 之前版本）

⚠️ 注意：自 Go 1.16 起，godoc 已从标准工具链中移除，官方推荐使用 pkg.go.dev 在线文档服务。若需本地运行文档服务器（如离线环境），仍可手动构建旧版 godoc。

执行以下命令（确保已正确安装 Go 并配置 GOPATH 和 PATH）：

Golang Naming

Go（Golang）命名规范 — 包括包、构造函数、结构体、接口、常量、枚举、错误、布尔值、接收器、getter/setter、函数等。

下载

# 确保 go 命令可用且版本 ≥ 1.12
go version

# 下载并安装 godoc（Go 1.15 及更早版本兼容）
go get golang.org/x/tools/cmd/godoc

# 验证安装（生成的二进制默认位于 $GOPATH/bin/godoc）
$GOPATH/bin/godoc -http=:6060

然后访问 http://localhost:6060 即可查看本地文档服务器。

? 关键配置检查：

确保 $GOPATH/bin 已加入 PATH（通常在 ~/.bashrc 或 ~/.zshrc 中添加）：
```
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin
```
执行 source ~/.bashrc（或对应 shell 配置文件）后，godoc 命令即可全局调用。

❌ 替代方案（不推荐）：
若坚持使用 apt，请统一选用 golang-go（含完整工具链）而非拆分安装，但该包在较新 Ubuntu 版本中已弃用；或彻底卸载 apt 版 Go，改用官方二进制安装——下载 .tar.gz 解压至 /usr/local/go，并设置 PATH=/usr/local/go/bin:$PATH，再通过 go install 安装工具，完全规避包管理器冲突。

? 总结：