完全合法，是go 1.12+多模块项目的标准做法；go原生支持workspace模式，允许多个go.mod共存，但需用go.work统一管理本地模块依赖并避免隐式冲突。
多个 go.mod 文件共存是否合法？
完全合法，且是 Go 1.12+ 多模块项目的标准做法。Go 工具链原生支持工作区（workspace）模式，允许一个代码仓库中存在多个独立模块，每个模块拥有自己的 go.mod。关键在于避免隐式依赖冲突——当子模块未被主模块显式 require，又未通过 replace 或 use 声明时，go build 可能静默使用老版本或本地未更新的缓存。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
CPWEB企业网站管理系统（以下称CPWEB）是一个基于PHP+Mysql架构的企业网站管理系统。CPWEB 采用模块化方式开发，功能强大灵活易于扩展，并且完全开放源代码，面向大中型站点提供重量级企业网站建设解决方案。CPWEB企业网站管理系统 2.2 Beta 测试版本，仅供测试，不建议使用在正式项目中，否则发生任何的后果自负。
- 根目录不强制放
go.mod；只有真正需要统一管理依赖或作为“主入口模块”的目录才设go.mod - 若多个模块需共享同一套依赖版本策略，用
go work init创建go.work文件，再go work use ./module-a ./module-b - 禁止在子模块的
go.mod中require同一仓库下的其他子模块路径（如require example.com/repo/module-b v0.0.0），这会绕过 workspace 控制，引发版本错乱
什么时候该用 go.work 而不是嵌套 replace？
当你要同时开发、调试多个本地模块，且希望它们彼此按当前源码状态实时联动（而非发布后的语义化版本），go.work 是唯一干净方案。replace 虽能临时指向本地路径，但它只作用于单个模块的 go.mod，无法跨模块统一生效，且易在 go mod tidy 后被意外清除或覆盖。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
-
go.work文件必须位于所有被引用模块的共同父目录下（通常为 Git 仓库根） - 添加新模块后，运行
go work use ./path/to/new-module，不要手动编辑go.work - CI 环境中禁用
go.work（默认不读取），应提前go work sync将依赖关系固化到各模块的go.mod中 - 执行
go run或go test时，当前工作目录若含go.work，工具链自动启用 workspace 模式——无需额外标志
go build 在多模块下为何总报 “missing go.sum entry”？
根本原因是：某个模块的 go.sum 缺失了它所依赖的另一个本地模块的校验条目。这通常发生在你新增了一个模块但没运行 go mod tidy，或在 go.work 下执行了 go mod tidy 却没指定目标模块路径。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 对每个模块单独运行
go mod tidy -modfile=./module-x/go.mod（注意指定-modfile），确保其go.sum包含全部直接/间接依赖的 checksum - 若模块 A 依赖模块 B，且二者都在 workspace 中，
go mod tidy在模块 A 目录下执行时，不会自动为模块 B 生成或更新go.sum条目——B 的校验信息必须由 B 自己的go mod tidy生成 - 检查错误信息中的具体路径，例如
example.com/repo/module-b@v0.0.0-00010101000000-000000000000这类伪版本，说明 Go 正在尝试校验一个未发布的本地模块，此时必须确认 B 模块已执行过go mod tidy
如何让 IDE（如 VS Code + Go extension）正确识别多模块结构？
VS Code 的 Go 扩展默认按打开的文件夹根目录查找 go.mod，若你打开的是整个仓库根，它只会加载根目录的模块（如果有的话），而忽略 go.work。结果就是跳转定义失败、无法补全子模块导出的符号。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 在仓库根目录创建
.vscode/settings.json，写入{"go.useLanguageServer": true, "go.toolsManagement.autoUpdate": true}，并确保已安装最新版gopls - 打开整个仓库根后，在命令面板（Ctrl+Shift+P）运行
Go: Restart Language Server，gopls会自动检测并加载go.work - 若仍不生效，检查
gopls日志（命令面板 →Go: Toggle Log），确认是否输出Detected go.work file；没有则说明go.work路径不对或格式有误 - 避免在子模块目录单独打开 VS Code 窗口——这会让
gopls降级为单模块模式，丢失跨模块感知能力
tidy、哪些会被 CI 忽略——这些边界一旦模糊，调试成本就指数上升。务必把 go.work 和每个 go.mod 的职责切清楚，别让“方便”变成“不可控”。 
