必须在含go.work的根目录执行go build等命令，子目录中执行会退化为单模块模式；同时需删除子模块go.mod中对本地模块的require声明，并确认go.work中use路径正确。
go work init 后 go build 报 “module xxx is not in main module” 怎么办
这不是配置失败，而是执行位置错了。Go 工具链只在 go.work 所在目录及其子目录下识别工作区上下文，但**只有在工作区根目录执行命令时，才会真正启用多模块解析逻辑**。
常见错误现象：
- 在 service_a/ 目录下运行 go build，报错 module lib_b is not in main module
- go.work 文件里明明写了 use ./lib_b，却依然找不到本地模块
- 必须在含
go.work的目录（如my_monorepo/）下执行go build、go run或go test - 子模块内部的
go.mod中，若还保留了对lib_b的require example.com/lib_b v0.1.0，要删掉或注释掉——工作区模式下，本地路径优先，require 版本会干扰解析 - 确认
go.work中的use路径是相对路径且可访问，比如use ./lib_b，不能写成use ../lib_b或绝对路径
replace 和 go work use 该选哪个
开发阶段，无条件选 go work use。它作用于整个工作区，不侵入单个模块的 go.mod，维护成本更低。
典型场景：你刚改完 lib_b 的一个函数，立刻想在 service_a 里验证调用效果。如果 service_a/go.mod 里用 replace 指向 ../lib_b，那只要 lib_b 目录挪动或重命名，service_a 就编译不过；而 go work use ./lib_b 是相对于工作区根的静态路径，只要项目结构不变，就一直有效。
-
replace写在某个go.mod里，只对该模块生效，CI 构建时仍需额外处理版本一致性 -
go work use是全局声明，所有加入工作区的模块自动共享同一套本地依赖视图 - 如果某个模块的
go.mod中已有replace覆盖了你想用的本地模块，go work不会覆盖它——得手动删掉那行replace -
go work use不支持通配符，每个模块都得显式列出，比如use ./service_a ./lib_b ./shared
CI/CD 流水线里能直接用 go work 吗
不能。标准 Go 工具链（包括 go test、go list、go build）在非工作区上下文中完全忽略 go.work 文件。CI 环境通常以 clean checkout + minimal env 启动，不会预设工作区。
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
立即学习“go语言免费学习笔记（深入）”；
这意味着：你在本地靠 go work 开发很爽，但 CI 里跑的还是传统单模块逻辑——每个子模块得单独 go mod tidy、单独构建、单独测试。
- CI 中应把每个子模块当作独立发布单元对待，确保其
go.mod自包含、可独立构建 - 工作区模式仅用于本地开发联调，不是构建交付产物的机制
- 如果强行在 CI 中模拟工作区（比如先
go work init再go build），会因路径不可控、缓存污染、权限问题导致不稳定 - 真正需要跨模块集成测试的场景，应在 CI 中用真实版本号（如
v0.2.0）发布到私有代理，再让下游模块require它
IDE（如 GoLand）对 go work 的支持现状
主流 Go IDE 已支持 go.work，但行为细节容易被忽略：GoLand 默认会读取 go.work 并据此索引所有 use 的模块，但**只在打开工作区根目录时才激活该行为**。
如果你双击打开了 service_a/main.go 却没同时打开 my_monorepo/ 根目录，IDE 可能只加载 service_a 单个模块，导致跳转不到 lib_b 的定义，或者提示 unresolved reference。
- 打开项目时，务必选择含
go.work的根目录，而不是某个子模块目录 - VS Code + Go extension 需要确保
"go.useLanguageServer": true，并重启语言服务器 - 修改
go.work后，部分 IDE 不会自动重载，需手动触发 “Reload project” 或重启编辑器 - IDE 的代码补全和类型检查依赖工作区上下文，但调试（debug）仍以当前运行目录为准——调试前确认终端 pwd 是工作区根
