报错“go: updates to go.mod needed, disabled by -mod=readonly”本质是gopls因模块状态不一致且启用只读模式而拒绝自动更新go.mod；唯一可靠修复是执行go mod tidy，并确保go111module=on、在项目根目录操作、检查gopls配置中是否误设-mod=readonly。
为什么VS Code总报“go: updates to go.mod needed, disabled by -mod=readonly”
这不是代码写错了，是 gopls 在只读模式下拒绝自动修正依赖状态。只要项目里有 go.mod，但 import 的包没被 require 声明（比如新加了 import "github.com/sirupsen/logrus" 却没运行 go mod tidy），gopls 就会卡住并报这个错。
根本原因只有两个：一是 go.mod 和实际代码 import 不一致；二是 gopls 被强制设为 -mod=readonly —— 它不会帮你改 go.mod，哪怕只是补一行 require。
- 检查
settings.json里有没有"go.goplsArgs": ["-mod=readonly"]或类似"go.toolsEnvVars"配置 - 运行
go env GOFLAGS，看输出是否含-mod=readonly - 旧版
gopls（v0.12.x 之前）可能在某些路径下 fallback 到只读模式，升级到最新版可规避
怎么确认 -mod=readonly 是谁启用的
别猜，直接验证。进项目根目录（即含 go.mod 的目录），终端执行：
gopls -rpc.trace -v check .
观察日志里是否出现类似 go [list -e -json -mod=readonly ] 的调用。如果有，说明 gopls 确实被喂了 -mod=readonly 参数。
- 优先查 VS Code 的
settings.json，尤其是go.goplsArgs和go.toolsEnvVars两项 - 其次查全局环境变量：
go env -w GOFLAGS=""可清空它（如果确实不需只读） - 若用的是老版本
gopls，直接go install golang.org/x/tools/gopls@latest升级
go mod tidy 是唯一可靠的修复动作
手动往 go.mod 里加 require 行是徒劳的。go mod tidy 才是 Go Modules 工作流的强制环节：它扫描全部 import、补全直接/间接依赖、删掉未用项、同步更新 go.sum。
- 必须在项目根目录执行，否则找不到
go.mod - 确保
GO111MODULE=on：go env -w GO111MODULE=on（别信auto，尤其在/tmp或非标准路径） - 如果之前失败过，先
go clean -modcache清缓存，再删掉go.sum（可选，避免校验冲突） - 执行后仍报错？看终端最后一行输出——大概率是代理或私有模块问题，比如
GOPROXY设成https://goproxy.cn但网络不通，或没配GOPRIVATE
GO111MODULE=on 时为什么不会自动创建 go.mod
因为 GO111MODULE=on 只改变依赖解析行为，不代替初始化动作。它不是“开关”，而是“就绪状态”。没有 go.mod 文件，go build 会直接报 go: cannot find main module，而不是默默建一个。
- 首次使用模块，必须手动
go mod init example.com/myapp，模块名要唯一、有意义（别用./mylib这种相对路径） - IDE 自动初始化不可靠——有些会在后台静默调用
go mod init，生成错误模块名（如project而非github.com/you/project），后续 CI 拉不到私有依赖 - 项目在
$GOPATH/src下却设GO111MODULE=on，Go 会忽略本地修改，只从$GOPATH/pkg/mod加载版本化依赖，调试会失效
真正容易被忽略的，是 go.sum 不是锁文件，而是哈希快照；删了再 go mod tidy 会重生成，但上游删 tag 后可能拉到不同 commit。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
