godoc注释中结构体链接跳转报错，如何修复？

1. 先确认GOROOT下的目录结构 #

执行命令检查标准库path/filepath的实际位置：

ls /usr/local/go/src/path/filepath

如果这个路径存在，说明godoc没正确识别源码目录结构；如果不存在，那你的Go安装路径可能有误，或者版本目录结构有变化，需要重新确认Go的安装位置。

2. 启动godoc时显式指定GOROOT #

直接在启动命令里指定Go根目录，跳过环境变量解析环节：

godoc -goroot=/usr/local/go -http=:6060

启动后再测试结构体链接跳转，大概率能解决路径找不到的问题。

3. 确保GOROOT环境变量全局生效 #

如果不想每次启动都加参数，就把GOROOT配置写入全局配置文件：

• 用bash的话，把export GOROOT=/usr/local/go添加到~/.bash_profile或~/.bashrc
• 用zsh的话，添加到~/.zshrc
  添加后执行生效命令：

# bash环境
source ~/.bash_profile
# zsh环境
source ~/.zshrc

之后重新启动godoc即可。

4. 更新godoc到最新版本 #

旧版本godoc可能存在路径解析bug，执行命令更新：

go install golang.org/x/tools/cmd/godoc@latest

更新完成后再启动测试。

内容的提问来源于stack exchange，提问作者Ado Ren