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

為了最大限度地減少使用哪個網站的困惑,我們計劃在今年晚些時候將來自 godoc.org 的流量重定向到 pkg.go.dev 上的相應頁面。我們需要您的幫助,以確保 pkg.go.dev 滿足我們所有使用者的需求。我們鼓勵大家現在就開始使用 pkg.go.dev 來滿足所有需求並提供反饋。

您的反饋將為我們的過渡計劃提供資訊,目標是將 pkg.go.dev 打造成我們包和模組的主要資訊和文件來源。我們確信您希望在 pkg.go.dev 上看到某些功能,我們希望聽取您關於這些功能的意見!

您可以透過以下渠道與我們分享您的反饋

作為此次過渡的一部分,我們還將討論 pkg.go.dev 的 API 訪問計劃。我們將在 Go issue 33654 上釋出更新。

常見問題

自 11 月釋出以來,我們收到了 Go 使用者關於 pkg.go.dev 的大量精彩反饋。在本文的其餘部分,我們認為回答一些常見問題會很有幫助。

我的包沒有顯示在 pkg.go.dev 上!如何新增?

我們會定期監控 Go 模組索引 以便將新包新增到 pkg.go.dev。如果您在 pkg.go.dev 上沒有看到某個包,可以透過從 proxy.golang.org 獲取模組版本來新增它。請參閱 go.dev/about 獲取說明。

我的包有許可證限制。這是怎麼回事?

我們理解在 pkg.go.dev 上無法完整看到您想要的包可能會令人沮喪。感謝您的耐心等待,我們正在改進許可證檢測演算法。

自 11 月釋出以來,我們已做出以下改進:

  • 更新了我們的許可證政策,包含我們檢測和識別的許可證列表
  • licensecheck 團隊合作,改進版權宣告的檢測
  • 建立了特殊情況的手動審查流程

一如既往,我們的許可證政策位於 pkg.go.dev/license-policy。如果您遇到問題,請隨時在 Go issue tracker 上提交問題,或傳送電子郵件至 go-discovery-feedback@google.com,以便我們直接與您合作!

pkg.go.dev 會開源嗎,以便我在工作中使用它處理我的私有程式碼?

我們理解擁有私有程式碼的公司希望執行支援模組的文件伺服器。我們希望幫助滿足這一需求,但我們認為我們對此的理解還不夠深入。

我們從使用者那裡瞭解到,執行 godoc.org 伺服器比應有的複雜,因為它設計用於公共網際網路規模的服務,而非僅限於公司內部。我們認為當前的 pkg.go.dev 伺服器也會存在同樣的問題。

我們認為,對於私有程式碼的使用,一個新伺服器更有可能是正確的解決方案,而不是讓每家公司都面臨執行網際網路規模的 pkg.go.dev 程式碼庫的複雜性。除了提供文件服務外,新伺服器還可以向 goimportsgopls 提供資訊。

如果您希望執行這樣的伺服器,請填寫這份3-5 分鐘的調查問卷,以幫助我們更好地瞭解您的需求。本次調查問卷將於 2020 年 3 月 1 日截止。

我們對 2020 年 pkg.go.dev 的未來感到興奮,希望您也一樣!我們期待收到您的反饋,並與 Go 社群一起推進此次過渡。

下一篇文章:Go 1.14 已釋出
上一篇文章:Go 1.15 提案
部落格索引