必须在go.work所在根目录执行go run .或go build,否则Go忽略工作区配置而退回到单模块逻辑;若子模块go.mod含require远程版本,还需用go work edit -replace补replace指令。
直接在 workspace 根目录下执行 go run . 或 go build,而不是进子模块里单独运行 —— 否则 go 会忽略 workspace 配置,退回到单模块逻辑。
go work use 没生效,go run 还是拉远程模块
根本原因是 go work use 只把本地模块路径注册进 go.work,但不修改任何 go.mod。如果某个模块 A 的 go.mod 里写的是 require example.com/b v0.1.0,而你本地改的是 ./b,那必须补一条 replace example.com/b => ./b 到 go.work 文件里。
- 执行
go work use ./module-a ./module-b(路径必须含go.mod) - 再手动加
replace:运行go work edit -replace example.com/b=./b - 确认
go.work文件里同时有use和replace块 - 别在
./module-a目录下执行go run main.go—— 这样go命令压根不读go.work
go run . 报 “main module does not contain package”
这是 workspace 下最常踩的坑:Go 不会向上查找 go.work,只认当前目录下的文件。报这个错,90% 是你没在 workspace 根目录执行命令。
- 先运行
go work edit -print,如果报no work file found,说明当前目录不对 - 用
find . -name go.work -type f找到真正 workspace 根目录,cd进去再试 -
go run .中的.必须指向一个含main函数的包,且该目录不能是子模块内部(比如不能是./module-a/) - CI/CD 脚本里不要依赖
go.work—— 上线构建应退回到单模块模式,用go build -mod=mod
多个 main 包文件怎么一起跑
Go 不自动合并同目录下的 .go 文件,哪怕都声明 package main。你得明确告诉它“这一整包都要编译”。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
- 首选
go run .:自动包含当前目录所有非_test.go的.go文件,跨平台、可靠 - 避免
go run *.go:Windows cmd 不展开通配符;Linux/macOS 下若存在xxx_test.go,会触发编译失败 - 禁止只跑一个文件,如
go run main.go:其他同包文件(utils.go、handler.go)完全不参与编译,必然报undefined - 所有文件必须包名一致,且不能有重复
func main()—— 否则报multiple main packages
workspace 的核心约束就两条:所有操作在根目录下进行,所有本地模块路径必须显式 use + 必要时 replace。漏掉任一环,Go 就当它不存在。
立即学习“go语言免费学习笔记(深入)”;

















