Go多模块项目需为各子目录（如backend、shared）分别初始化独立go.mod，通过require+replace实现模块间引用，构建测试须按模块目录执行，发布时需打tag并保持module路径与版本一致。
在 Go 中管理多模块项目，核心是合理使用 go.mod 文件和 Go 的模块（module）机制，而不是依赖传统意义上的“子模块”或包嵌套。Go 官方不支持一个项目内多个 go.mod 共存于同一构建上下文（除非明确分属不同模块），但可通过“多模块仓库”（multi-module repository）方式，在单个 Git 仓库中维护多个独立模块，实现逻辑隔离与按需引用。
明确模块边界：每个模块拥有独立 go.mod
若需隔离（如 backend、shared、cli 等职责分明的组件），应在各自目录下初始化独立模块：
- 进入
./backend目录，运行go mod init example.com/myapp/backend - 进入
./shared目录，运行go mod init example.com/myapp/shared - 每个模块的
import path必须唯一，且与本地路径无强绑定（Go 不要求路径匹配，但强烈建议保持一致以避免混淆）
模块间引用：用导入路径 + replace（开发期）或版本号（发布后）
当 backend 需要使用 shared 的功能时，在 backend/go.mod 中添加：
require example.com/myapp/shared v0.1.0
开发阶段未发布版本时，用 replace 指向本地路径，绕过远程拉取：
立即学习“go语言免费学习笔记（深入）”；
replace example.com/myapp/shared => ../shared
该 replace 只作用于当前模块，不影响其他模块，是实现本地协同开发的关键。
构建与测试：按模块独立操作，避免跨模块隐式依赖
不要在根目录执行 go build 或 go test —— 根目录无 go.mod 则不属于模块；有则可能错误聚合所有子目录。
- 构建 backend：
cd backend && go build -o bin/backend ./cmd/server - 测试 shared：
cd shared && go test ./... - 确保各模块的
go.test或main包不意外 import 其他模块未导出的内部路径（如shared/internal），否则破坏封装
发布与版本控制：打 tag 前先规范模块版本
发布 shared 模块时：
- 在
shared/目录下执行git tag v0.1.0 - 确保
shared/go.mod中 module 名与 tag 路径一致（如example.com/myapp/shared） - 其他模块可直接
go get example.com/myapp/shared@v0.1.0，并自动更新go.mod
注意：不同模块可使用不同主版本（如 shared/v2），只需调整 module 路径末尾（example.com/myapp/shared/v2），Go 会将其视为全新模块。
