goland未生成go.mod需先确认模块模式是否启用：检查右下角是否显示“go modules”，运行go list -m验证，勾选settings→go→go modules中“enable go modules integration”，并在终端根目录手动执行go mod init github.com/yourname/reponame，避免ide自动创建路径错误。
GoLand里没生成go.mod？先确认是否真在模块模式下
GoLand默认会按当前目录是否有go.mod文件来决定用模块模式还是GOPATH模式。如果项目打开后右下角没显示“Go Modules”或提示“GO111MODULE=off”，说明它根本没识别成模块——哪怕你手动建了go.mod，也可能因路径不对或缓存未刷新而失效。
检查点：
– 打开终端，在项目根目录运行go list -m，输出应为模块路径；若报错go: not in a module，就是没生效
– GoLand中点击File → Settings → Go → Go Modules，确认Enable Go modules integration已勾选
– 不要依赖IDE自动创建go.mod，它有时只生成空文件或写错路径
执行go mod init时模块路径写错，后续全乱套
模块路径不是随便起的别名，它直接决定所有import语句怎么写、依赖怎么解析。GoLand里点“New → Module”再选“Go module”容易把路径设成myproject这种本地名，结果导致：
– import "myproject/internal/log"在别人机器上根本找不到
– go get拉不到你发布的版本
– 升级到v2+时因缺少/v2后缀直接失败
正确做法：
– 在终端cd进项目根目录，手动运行go mod init github.com/yourname/reponame（即使还没推送到GitHub）
– 路径里不能有空格、中文、下划线开头，推荐全小写+短横线
– 如果已有代码用了旧导入路径（如"myapp/utils"），go mod init不会自动改，得自己全局替换
GoLand自动下载依赖失败？多半是GOPROXY没配对
GoLand调用go get时走的是系统环境变量，不是IDE内置代理。常见现象：终端里go get能成功，但GoLand里点“Sync dependencies of project”一直转圈或报cannot find module。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
必须同步配置两处：
– 终端里确认go env GOPROXY输出非空（推荐https://goproxy.cn,direct）
– GoLand中Settings → Go → Go Modules → Proxy URL填同样地址，且勾选Use proxy for private repositories
– 如果公司内网有私有代理，direct不能删，否则内部模块拉不到
重构后import爆红？GoLand缓存没清干净
改完go.mod、换过模块路径、加了replace指令，GoLand编辑器里import行仍标红、跳转失效、代码补全不出来——这不是代码问题，是IDE索引滞后。
别重启或重装，三步清掉缓存：
– File → Close Project关掉项目
– 删除项目根目录下的.idea文件夹和go.work（如有）
– 重新用Open打开项目（不是Open Recent），让它重建索引
额外提醒：如果项目里有go.work文件，GoLand会优先用它管理多模块，此时单个go.mod的改动可能被忽略——删掉go.work再试
go.mod，所有import语句、CI脚本里的go build路径、甚至Dockerfile里的COPY目标都得跟着改，这个连锁反应很多人等到CI挂了才意识到。
