Go 博客

pkg.go.dev 的下一步

Julie Qiu
2020年1月31日

2019 年，我们推出了 go.dev，一个面向 Go 开发人员的新中心。

作为网站的一部分，我们还推出了 pkg.go.dev，这是一个关于 Go 包和模块信息的集中来源。与 godoc.org 一样，pkg.go.dev 提供 Go 文档。但是，它也了解模块，并提供有关包过去版本的信息！

在今年剩余时间里，我们将向 pkg.go.dev 添加功能，以帮助我们的用户更好地了解其依赖项，并帮助他们做出有关导入哪些库的更好决策。

为了最大程度地减少关于使用哪个网站的困惑，今年晚些时候，我们计划将来自 godoc.org 的流量重定向到 pkg.go.dev 上的相应页面。我们需要您的帮助来确保 pkg.go.dev 满足我们所有用户的需求。我们鼓励每个人今天开始将 pkg.go.dev 用于所有需求，并提供反馈。

您的反馈将为我们的过渡计划提供信息，目标是使 pkg.go.dev 成为我们包和模块的主要信息和文档来源。我们相信您一定想在 pkg.go.dev 上看到一些东西，我们希望听到您关于这些功能的想法！

您可以通过以下渠道与我们分享您的反馈

作为此过渡的一部分，我们还将讨论对 pkg.go.dev 的 API 访问计划。我们将在 Go 问题 33654 上发布更新。

自从 11 月份推出以来，我们收到了 Go 用户关于 pkg.go.dev 的大量宝贵反馈。在本文的其余部分，我们认为回答一些常见问题将很有帮助。

我们定期监控 Go 模块索引以查找要添加到 pkg.go.dev 的新包。如果您在 pkg.go.dev 上看不到某个包，可以通过从 proxy.golang.org 获取模块版本来添加它。请参阅 go.dev/about 获取说明。

我们理解，无法在 pkg.go.dev 上完整查看所需的包可能会令人沮丧。感谢您耐心等待我们改进许可证检测算法。

自从 11 月份推出以来，我们做出了以下改进

与往常一样，我们的许可证政策位于 pkg.go.dev/license-policy。如果您遇到问题，请随时在 Go 问题跟踪器上提交问题，或发送电子邮件至 [email protected]，以便我们可以直接与您合作！

我们了解拥有私有代码的公司希望运行一个提供模块支持的文档服务器。我们希望帮助满足这一需求，但我们认为我们还没有充分了解它。

我们从用户那里了解到，运行 godoc.org 服务器比预期的要复杂，因为它旨在用于服务于公共互联网规模，而不是仅在公司内部。我们认为当前的 pkg.go.dev 服务器也会存在相同的问题。

我们认为，一个新的服务器更有可能成为与私有代码一起使用的正确答案，而不是让每个公司都面临运行互联网规模的 pkg.go.dev 代码库的复杂性。除了提供文档外，新服务器还可以向 goimports 和 gopls 提供信息。

如果您想运行这样的服务器，请填写此 3-5 分钟调查问卷 以帮助我们更好地了解您的需求。此调查问卷将在 2020 年 3 月 1 日之前可用。

我们对 2020 年 pkg.go.dev 的未来感到兴奋，我们希望您也一样！我们期待着收到您的反馈并与 Go 社区合作完成此过渡。

下一篇文章：Go 1.14 发布
上一篇文章：Go 1.15 的提案
博客索引