Go 1.11 引入模块机制取代 GOPATH，通过 go mod init 初始化、语义化版本标签发布、import 导入及 replace 本地替换实现多模块管理；私有模块需配置 GOPRIVATE 和 Git URL 重写，国内可设 GOPROXY 加速。
Go 1.11 引入了模块（module）机制，取代了传统的 GOPATH 工作模式，让多模块管理、项目拆分与跨模块导入变得清晰可控。关键在于正确初始化模块、设置模块路径、发布版本，并在主项目中按需引用。
初始化独立模块并规范命名
每个可复用的子模块应有独立仓库和唯一模块路径（通常为 VCS 地址，如 github.com/yourname/utils）。在该模块根目录执行：
-
go mod init github.com/yourname/utils —— 初始化模块，生成 go.mod
- 编写导出函数/类型，确保首字母大写（如 func FormatTime(...)）
- 提交代码并打语义化标签（如 git tag v0.1.0），便于下游引用固定版本
在主项目中导入并使用外部模块
主项目无需在 GOPATH 下，直接在任意目录初始化模块：
-
go mod init myapp —— 创建主模块
-
import "github.com/yourname/utils" —— 在 .go 文件中导入
-
go build 或 go run 时自动下载依赖，写入 go.mod 和 go.sum
- 如需指定版本，可用 go get github.com/yourname/utils@v0.1.0
本地开发时临时替换模块路径（replace）
当子模块还在本地调试、未推送到远程，或需覆盖线上版本时，在主项目的 go.mod 中添加 replace 指令：
-
replace github.com/yourname/utils => ../utils —— 指向本地文件路径
-
replace github.com/yourname/utils => ./local-utils —— 同目录下子文件夹
- 执行 go mod tidy 后生效，编译运行即使用本地代码
- 上线前记得删掉 replace 行，改用真实版本号引用
私有模块与代理配置（可选进阶）
若模块托管在私有 Git 服务器（如 GitLab、自建 Gitea），需配置：
-
go env -w GOPRIVATE=git.example.com/myorg —— 跳过
代理和校验
-
git config --global url."ssh://git@git.example.com:".insteadOf "https://git.example.com/" —— 支持 SSH 克隆
- 国内环境可配代理加速公共模块：go env -w GOPROXY=https://proxy.golang.org,direct
代理和校验