Go模块路径是go.mod首行字符串，作为依赖解析、下载和校验的唯一标识，须与代码托管地址一致；本地多模块用replace重定向，远程模块用go get或go mod tidy管理，路径必须完整准确。
Go 使用模块（mod
ule）系统管理依赖，包路径是模块引用的核心。正确设置和使用包路径，能清晰区分本地开发包、本地其他模块、以及远程第三方模块。
理解 Go 模块路径的本质
模块路径（module path）是 go.mod 文件第一行的字符串，例如 github.com/yourname/project。它不仅是导入时的前缀，更是 Go 工具链解析依赖、下载远程代码、校验版本的唯一标识。
关键规则：
- 模块路径应与代码托管地址一致（如 GitHub URL），否则
go get无法自动定位远程仓库 - 本地未发布的模块，路径可以是任意合法字符串（如
myapp/internal/util），但需确保不与公共路径冲突 - 同一项目中所有子包的导入路径必须以该模块路径为前缀
引用本地其他模块（多模块项目）
当项目拆分为多个独立模块（如 api 和 core），且都位于本地文件系统时，不能靠 go get 下载，需用 replace 指令重定向：
假设目录结构如下：
~/myproject/
├── api/
│ └── go.mod # module github.com/you/api
└── core/
└── go.mod # module github.com/you/core
在 api/go.mod 中添加：
replace github.com/you/core => ../core
然后在 api/main.go 中即可正常导入："github.com/you/core"。构建时 Go 会从 ../core 加载源码，而非尝试拉取远程版本。
引用远程模块（标准方式）
直接使用 go get 或在代码中首次导入后运行 go mod tidy：
-
go get github.com/spf13/cobra@v1.9.0：拉取指定版本，写入go.mod -
go get github.com/spf13/cobra@latest：拉取最新发布版 - 若导入语句为
import "github.com/gorilla/mux"，执行go mod tidy后会自动发现并添加对应模块
注意：模块路径必须完整准确。例如 import "mux" 会报错，Go 不支持短路径别名。
避免常见路径陷阱
以下做法容易引发构建失败或行为异常：
- 在
go.mod中声明路径为example.com/mylib，但实际代码托管在github.com/you/mylib——go get将无法解析 - 本地开发时修改了模块路径（如从
github.com/you/lib改成mylib.local），但未同步更新所有import语句 - 跨模块引用时忘记
replace，导致go build尝试下载不存在的远程版本而报错module not found
调试建议：用 go list -m all 查看当前解析的所有模块及其来源路径；用 go mod graph | grep target 检查依赖关系是否符合预期。
