多模块项目在goland中必须显式设置go111module=on，否则默认fallback至gopath模式导致依赖解析失败；需在终端执行go env -w go111module=on，并在goland settings→go→go environment中手动添加该变量，确保terminal中go env go111module输出为on。
GoLand 里多模块项目必须显式设置 GO111MODULE=on
多模块项目（即根目录无 go.mod，但子目录各自有独立 go.mod）在 GoLand 中默认会 fallback 到 GOPATH 模式，导致 go list -m 报错、依赖无法解析、甚至 import 提示红色下划线。根本原因是 GoLand 启动时未继承 shell 的模块开关状态。
实操建议：
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 不要依赖
GO111MODULE=auto—— 它在跨目录切换时行为不稳定，尤其当当前工作目录不在任一模块内时会禁用模块 - 全局强制启用：在终端执行
go env -w GO111MODULE=on，确保所有新启动的进程都生效 - GoLand 内单独加固：进入 File → Settings → Go → Go Environment，在
Environment字段中手动添加GO111MODULE=on - 验证方式：在 GoLand Terminal 中运行
go env GO111MODULE，输出必须是on，不是auto或空
GOROOT 和 GOPATH 在多模块项目中怎么设才不冲突
GOROOT 必须唯一且指向 Go 安装根目录；GOPATH 在多模块场景下已完全退居二线，但若项目含 legacy 脚本或 CI 工具链调用 go get，仍可能被读取。错误配置会导致 go install 输出二进制到 GOROOT/bin，覆盖工具链。
实操建议：
-
GOROOT值必须与where go（Windows）或which go（macOS/Linux）返回路径的父目录一致，例如go在D:\Go\bin\go.exe，则GOROOT=D:\Go，末尾不能加反斜杠 -
GOPATH可设为任意空目录（如D:\go-workspace），只要不和GOROOT相同；Windows 用户务必设为「用户变量」而非系统变量 - Path 中只保留
%GOROOT%\bin，不要加入 %GOPATH%\bin —— 多模块项目不依赖它，加了反而干扰go install输出位置判断 - GoLand 的 SDK 配置（Settings → Go → GOROOT）必须与系统环境变量值严格一致，否则 IDE 内部诊断会失败
多模块项目依赖下载失败？先检查 GOPROXY 和 GOSUMDB
单模块项目能拉包，多模块却卡在 go mod download 或提示 verifying github.com/xxx@vX.Y.Z: checksum mismatch，大概率是代理或校验配置未被子模块继承。
实操建议：
- 代理必须用逗号分隔的双值格式：
GOPROXY=https://goproxy.cn,direct——direct是 fallback，缺它会导致私有模块失败 - 校验数据库必须显式设置：
go env -w GOSUMDB="sum.golang.org"或国内镜像"gosum.io+ce6e75650+AY5qEHUk/qmHc5btzW45JVoENfazw8LielDsaI+lEbq6" - GoLand 的模块设置（Settings → Go → Go Modules）中
Environment字段要同步填入GOPROXY和GOSUMDB，否则 Run Configuration 启动时不会加载 - 子模块内执行
go mod tidy前，先确认当前终端 pwd 在该子模块根目录（含go.mod），否则会误操作上级目录
GoLand 运行多模块项目时找不到 main 包？检查 Working directory 和 Module Root
点击绿色三角运行后报错 build command-line-arguments: cannot find module for path . 或 no required module provides package，说明 GoLand 没识别出当前文件属于哪个模块上下文。
实操建议：
- 每个子模块必须有独立的 Run Configuration：右键
main.go→ Run 'main.go'，GoLand 会自动推导Working directory为该文件所在目录的最近go.mod根目录 - 手动检查配置：打开 Edit Configurations → Working directory，值应为子模块根路径（含
go.mod），不是项目总根目录 - 避免在总项目根目录下新建
go run配置 —— 它没有关联任何go.mod，Go 会拒绝构建 - 如果子模块间有跨模块 import（如
import "myproj/submodule2"），需确保该路径已在总项目的replace或require中声明，否则go build会失败
go env 并不会自动刷新已有配置。每次新增子模块，都要右键它的 main.go 重新生成一次运行配置。
