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 下，直接在任意目录初始化模块：

git摸鱼周报自动化

生成周报：读取本机 Git 仓库最近一周的提交记录，按项目分类提炼总结，生成标准周报格式，通过微信推送并返回给用户。触发词：周报、weekly report、git总结、提交记录总结、工作周报。

下载

• 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 指令：

立即学习“go语言免费学习笔记（深入）”；

• 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