GoDoc找不到包？快速配置指南

本文解决Godoc显示“找不到包”的常见问题，该问题通常出现在尝试使用godoc浏览自定义Go包时。文章指出错误原因在于godoc无法正确定位自定义包，并详细讲解了四步解决方法：确保自定义包位于`$GOPATH/src`目录下且路径与`go.mod`文件中的模块路径一致；更新`go.mod`文件，正确声明模块信息；使用`go build`编译自定义包；在包含`go.mod`文件的根目录下运行`godoc -goroot=.`命令启动服务。 通过这些步骤，即可在浏览器中成功访问自定义包的文档。 文章还提供了实际操作示例，方便读者理解和操作。

使用godoc浏览自定义Go包时遇到“找不到包”错误？

godoc是Go语言的文档生成工具，方便开发者在浏览器中查看Go包的文档。然而，在尝试查看自定义包时，常常出现“cannot find package”的错误提示，例如：

cannot find package "." in: /src/hosts

如何解决？

此问题通常源于godoc无法正确找到您的自定义包。请按照以下步骤排查并解决：

1. 正确放置自定义包： 您的自定义包必须位于$GOPATH/src目录下。 确保hosts包位于该目录的正确子目录中，路径应与go.mod文件中的模块路径一致。

2. 更新go.mod文件： go.mod文件声明了您的Go模块信息，必须包含对自定义包的引用。 如果不存在，请添加以下内容（将stephanie.io/hosts替换为您的实际模块路径）：

编译自定义包： 使用go build命令编译您的自定义包，确保没有编译错误。



启动godoc服务： 使用godoc -goroot=.命令启动godoc服务。关键点：  请确保在包含go.mod文件的自定义包的根目录下运行此命令。


浏览器访问： 在浏览器中访问http://localhost:6060/pkg/hosts (或您的包路径)。

实际操作示例：
假设您的自定义包位于/users/stephanie/go/src/stephanie.io/hosts目录：
进入包目录：cd /users/stephanie/go/src/stephanie.io/hosts
修改go.mod文件，添加上述require语句。
运行go build。
运行godoc -goroot=.。
在浏览器中访问http://localhost:6060/pkg/stephanie.io/hosts。
按照以上步骤，godoc应该能够正确显示您的自定义包文档。  如果问题依旧，请检查GOPATH环境变量是否正确设置，以及go.mod文件中的模块路径是否与实际文件路径一致。
今天关于《GoDoc找不到包？快速配置指南》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！