Go项目需在含go.mod的根目录运行，否则go run会报“main module does not contain package”；应检查目录、初始化模块、正确使用replace或workspace、注意GOFLAGS及跨平台构建参数。
Go 项目不是“拿来就能用”的压缩包，它必须在正确的工作目录下、以正确的模块上下文运行。直接 go run main.go 失败，大概率是因为当前目录没有 go.mod，或者 go.mod 里缺失关键依赖声明。
go run 报错 “main module does not contain package” 怎么办
这是最常遇到的启动失败提示，本质是 Go 不知道该从哪个模块开始解析代码。
- 确认你当前在项目根目录（即包含
go.mod的目录），而不是子文件夹里执行go run main.go - 检查
go.mod文件是否存在且内容合法：第一行必须是module your-module-name，不能是空的或写成注释 - 如果项目是从 Git 克隆的，但没带
go.mod，别硬跑——先执行go mod init your-module-name初始化 -
go run默认只认当前模块下的package main；如果你的main.go在cmd/myapp/下，得写成go run cmd/myapp，不能只写main.go
本地模块依赖不生效，go run 还是去拉远程版本
当你自己写了 github.com/you/utils 模块，并在主项目里 import "github.com/you/utils"，但 go run 仍报错找不到包或拉了旧版，说明模块未被正确纳入构建上下文。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 单模块项目：在主项目根目录执行
go mod edit -replace github.com/you/utils=../utils，再go mod tidy刷新依赖 - 多模块 workspace：确保已执行
go work init和go work use ./utils，且go.work文件在你运行go run的当前目录下 - 别忽略
GOFLAGS：如果设了-mod=readonly，go mod tidy会静默失败，导致 replace 不写入go.mod
go build 后生成的二进制无法运行，提示 missing symbol 或 panic at startup
这不是代码逻辑问题，而是构建环境与目标环境不一致导致的链接失败或运行时缺失。
立即学习“go语言免费学习笔记（深入）”；
- 跨平台构建记得加
GOOS和GOARCH：比如在 macOS 上编译 Linux 版本，要写GOOS=linux GOARCH=amd64 go build - 禁用 CGO 可避免动态链接依赖：加
CGO_ENABLED=0，尤其适合容器部署（如 Alpine 镜像） - 检查是否用了
os/exec或net/http等隐式依赖系统工具链的包——某些精简镜像里缺/bin/sh或 DNS 解析库，会导致 panic
真正卡住人的地方，往往不是语法或逻辑，而是模块路径和构建上下文这两个隐形开关没对齐。每次执行前，花 3 秒看一眼当前目录、go.mod 是否存在、go env GOPATH 是否干扰了查找路径，比反复改代码更省时间。
