go跨包复用核心是导入路径与文件系统、go.mod、git仓库三者严格一致：需用可导出标识符、合法import path、模块初始化（go.mod），避免gopath干扰，私有包可通过replace或git url共享。
Go 语言没有传统意义上的“公共模块”概念，跨包复用靠的是可导出标识符 + 明确的包路径，不是靠“发布到中心仓库”或“安装模块”。你不需要像 Node.js 那样 npm publish，也不需要像 Python 那样 pip install —— Go 的跨包依赖本质是 import 路径解析 + 模块版本控制（go.mod）。
如何让多个包能 import 同一个自定义包
核心是：被引用包必须有合法的、可解析的导入路径（import path），且该路径要与文件系统结构一致。
- 被复用的包不能放在
main包下，也不能是未命名包（package main） - 包所在目录必须是模块根目录下的子目录，且该模块已初始化（即存在
go.mod文件） - 导入时写的是模块名 + 子路径，例如模块名为
github.com/yourname/utils，包在utils/stringutil目录下，则导入为"github.com/yourname/utils/stringutil" - 如果只是本地多包协作（不对外发布），模块名可以是任意合法域名（如
example.com/myproject），只要所有import语句与go.mod中的module声明一致即可
为什么 go build 报错 “cannot find package”
常见于路径不匹配、模块未启用或 GOPATH 干扰。Go 1.16+ 默认启用 module mode，但若当前目录无 go.mod 或环境变量 GOPATH 被误设，仍可能 fallback 到旧模式。
- 确认当前工作目录下运行过
go mod init example.com/myproject，且所有子包都在该模块路径下 - 检查
import路径是否拼写错误，特别是大小写（Linux/macOS 下严格区分） - 避免在
$GOPATH/src下直接开发 —— 这会触发 GOPATH mode，导致模块路径失效 - 运行
go list -m all查看当前模块依赖树，确认目标包是否出现在列表中
如何把私有工具包分享给团队其他项目
不依赖中心仓库也能共享：用 Git URL + replace 或直接 require 版本。
立即学习“go语言免费学习笔记（深入）”；
- 将工具包推送到内部 Git 服务器（如 GitLab、Gitee、自建 Gitea），确保有稳定 tag（如
v0.1.0） - 在业务项目的
go.mod中添加：require github.com/team/utils v0.1.0 - 若工具包尚未打 tag 或需临时调试，可在
go.mod末尾加：replace github.com/team/utils => ../utils（相对路径）或replace github.com/team/utils => git@company.com:team/utils.git v0.1.0-xxx -
replace只在当前模块生效，上线前务必删掉并改用正式require，否则 CI 构建会失败
发布到公网（如 GitHub）后别人 import 不到？
不是 Go 的问题，是网络或 Git 配置问题。Go 本身只做 git clone，不走代理或镜像。
- 确认目标仓库是公开的（private 仓库需配置 SSH key 或 token）
- 国内用户常因网络问题拉不到 GitHub，可设置 GOPROXY：
export GOPROXY=https://goproxy.cn,direct - 若用 SSH 地址（
git@github.com:user/repo.git）但未配好 SSH key，go get会卡住或报 permission denied —— 改用 HTTPS 地址或补全 SSH 配置 - 模块根目录必须包含
go.mod，且module行声明的路径必须和 Git 仓库地址完全一致（包括大小写）
跨包复用的关键不在“怎么发布”，而在“路径怎么对得上”。很多人卡在 import 路径和文件系统、go.mod、Git 仓库三者不一致，而不是语法或工具链问题。
