開發包時,在發布包之前在本地預覽其文檔會很有幫助。雖然 godoc 命令可以產生文字文檔,但它還提供了 HTTP 伺服器模式,用於在瀏覽器中顯示文檔。但是,您可能會遇到使其正常工作的困難。
如果您遇到 godoc -http=:6060 不顯示您自己的套件的文件而是顯示 Go 主頁的問題,請確保套件位於正確的路徑中。預設情況下,godoc 在 GOPATH 或模組原始碼樹中搜尋包。如果你的包在這些目錄之外,它將找不到。
在 GOPATH 模式下:
在 GOPATH 模式下工作時,godoc -http 將為所有可用的軟體包,包括標準函式庫。要查看套件的文檔,只需導航至 http://localhost:6060/pkg/your/package。
在模組感知模式中:
在模組中-感知模式下,godoc 與 GOPATH 不相容。因此,要在本地查看模組的文檔,您需要將其原始程式碼放在 src 資料夾中。例如,如果您的模組位於目錄 /home/user/mymodule 中,請在其中建立名為 src 的新目錄,並將模組的來源檔案移到那裡。
一旦來源檔案位於src 資料夾中,使用以下命令啟動godoc:
godoc -goroot=/home/user/mymodule -http=:6060
這應該允許您在以下位置查看套件的文件:http://localhost:6060/ pkg/mymodule.
以上是如何使用'godoc”在瀏覽器中本地查看我的 Go 包文件?的詳細內容。更多資訊請關注PHP中文網其他相關文章!