不能,pkgsite默认只服务proxy.golang.org已发布的模块;需配置本地goproxy、合法go.mod路径、手动go mod download,并设goproxy指向本地代理才能加载本地未发布模块。

pkgsite 能不能直接看本地 Go 项目文档?
不能,pkgsite 默认只服务已发布到 proxy.golang.org 的模块,本地未发布的代码不会被自动索引。它不是 godoc 那种开箱即用的本地文档服务器。
想用 pkgsite 看自己写的包,必须让它的后端“认为”这个模块是可解析的——核心是伪造一个可用的模块路径,并让它能被 go list -m -json 和 go mod download 流程识别。
- 你的模块必须有
go.mod文件,且module声明不能是伪路径(如example.com/myproj可以,./myproj不行) - 需要在本地启动
pkgsite并配置为使用本地 Go proxy 缓存(而非直连官方 proxy) - 首次访问前,得手动触发一次
go mod download,让模块进到本地 cache($GOCACHE/download)里
怎么让 pkgsite 读到本地未发布的模块?
关键是绕过远程 fetch,改用本地 goproxy + pkgsite 组合。最轻量的做法是用 goproxy 搭一个只服务本地模块的代理,再让 pkgsite 从它拉数据。
实操步骤:
立即学习“go语言免费学习笔记(深入)”;
- 确保
GO111MODULE=on,且项目根目录有合法go.mod(比如module github.com/you/proj) - 运行
goproxy -proxy=localhost:8081 -cache=/tmp/goproxy-cache(它会监听本地 8081) - 设置环境变量:
export GOPROXY=http://localhost:8081,direct - 执行
go mod download github.com/you/proj@latest—— 这步会把本地模块打个临时 tag 并缓存进去 - 启动
pkgsite:pkgsite -http=:8082 -proxy=http://localhost:8081 - 浏览器打开
http://localhost:8082/github.com/you/proj
注意:pkgsite 不会实时监听文件变更,改了代码要重新 go mod download 才能刷新文档。
本文档主要讲述的是在Android中查看和管理sqlite数据库;在Android中可以使用Eclipse插件DDMS来查看,也可以使用Android工具包中的adb工具来查看。android项目中的sqlite数据库位于/data/data/项目包/databases中。有需要的朋友可以下载看看
为什么 pkgsite 显示 “module not found” 却 go build 正常?
因为 pkgsite 查的是 module path(即 go.mod 第一行),不是文件路径。常见坑:
-
go.mod里写的是module .或module myproj—— 这属于非法 module path,pkgsite直接忽略 - 模块路径含大写字母或下划线(如
MyProj),Go 官方工具链不认可,pkgsite也不会处理 - 本地没设
GOPROXY,pkgsite默认去proxy.golang.org找,自然 404 -
go list -m -json在当前目录下执行失败(比如不在 module 根目录),pkgsite就没法推导出有效路径
验证方法:在项目根目录运行 go list -m -json,输出里必须有非空的 Path 字段,且和浏览器访问的 URL 路径完全一致。
替代方案比硬刚 pkgsite 更省事?
如果只是临时查本地包结构、函数签名、注释,godoc(旧版)或 go doc CLI 更直接:
-
go doc -http=:6060启动本地服务,访问http://localhost:6060/pkg/—— 支持未发布模块,实时响应 -
go doc github.com/you/proj或go doc github.com/you/proj.MyFunc查具体项 - VS Code + Go 插件按
Ctrl+Click跳转也能渲染大部分注释,无需额外服务
pkgsite 的优势在于 UI 和跨模块链接能力,但代价是强依赖模块发布流程。对纯本地开发来说,它不是默认最优解,而是特定部署场景下的选择。
真正卡住的往往是模块路径命名和 GOPROXY 链路是否闭环——这两点没对齐,后面所有步骤都白搭。









