go.work是Go 1.18引入的工作区配置文件，用于在单体仓库中统一管理多个模块。通过go work init初始化并使用go work use添加模块后，可在开发时让模块直接引用本地代码，无需replace指令。例如在my-mono-repo中包含user-service、order-service和shared模块时，只需在根目录创建go.work文件声明use路径，即可使各服务导入mycompany/shared/utils等共享包并自动解析为本地路径。该机制提升多模块协作效率，仅限开发期使用，不影响生产构建。
Go 1.18 引入了工作区模式（workspace mode），通过 go.work 文件让你在一个项目中管理多个模块，特别适合单体仓库（mono-repo）或多模块协作开发。使用 go.work 可以让不同模块之间直接引用本地代码，无需发布或修改 go.mod 中的 replace 指令。
什么是 go.work 和工作区模式？
工作区模式允许你将多个模块目录组合成一个逻辑工作区。当你在该工作区下运行 go build、go run 或 go test 时，Go 工具链会自动优先使用本地模块路径，而不是从远程下载。
核心是根目录下的 go.work 文件，它由 go work init 命令生成，用来声明包含哪些模块路径。
创建和配置 go.work 文件
假设你的项目结构如下：
立即学习“go语言免费学习笔记（深入）”；
my-mono-repo/
├── go.work
├── user-service/
│ └── main.go
│ └── go.mod
├── order-service/
│ └── main.go
│ └── go.mod
└── shared/
└── utils/
└── helper.go
└── go.mod
其中 shared 是被其他服务共用的模块。
步骤 1：初始化工作区进入项目根目录，执行：
go work init步骤 2：添加模块到工作区
依次添加各个模块目录：
go work use ./user-service go work use ./order-service go work use ./shared
这会在根目录生成或更新 go.work 文件，内容类似：
go 1.21
use (
./user-service
./order-service
./shared
)
跨模块引用本地包
假设 user-service 需要使用 shared/utils 中的函数。
确保 shared/go.mod 中定义了模块名，例如：
// shared/go.mod module mycompany/shared go 1.21
然后在 user-service/main.go 中导入：
import "mycompany/shared/utils"
由于工作区已启用，Go 会自动使用本地 ./shared 目录，无需手动加 replace 指令。
你可以在 user-service/go.mod 中看到：
require mycompany/shared v0.0.0
这个版本号会被 go.work 覆盖，实际走本地路径。
验证和常见问题处理
检查当前工作区状态：
go work read
输出当前 go.work 的解析结果，确认模块路径是否正确加载。
测试构建：
cd my-mono-repo go build -v ./user-service
如果能成功编译并找到 shared 包，说明配置成功。
注意事项：
- 所有模块必须有独立的 go.mod 文件
- 模块导入路径（import path）必须与 go.mod 中的 module 名一致
- go.work 只在开发期生效，不提交到生产构建中（CI/CD 通常不用工作区）
- IDE 支持需开启 Go workspace 模式（如 Goland、VS Code）
基本上就这些。go.work 让多模块开发更顺畅，省去频繁 replace 的麻烦，提升本地协作效率。
