GoLand 能直接运行 Iris 项目，但必须先正确配置 GOROOT 和启用 Go Modules，再执行 go mod init 初始化模块、用 go get github.com/kataras/iris/v12@v12.2.0 安装依赖，并在 Run Configurations 中设 Package 模式及正确工作目录。
GoLand 能直接运行 Iris 项目，但必须先解决模块识别和 SDK 配置两个硬性前提，否则 main.go 里连 iris.New() 都没代码提示，更别说调试运行。
GoLand 启动前必须确认 GOROOT 和 Go Modules 已启用
GoLand 不会自动继承系统终端的环境变量，哪怕你在 CMD 里执行过 go env -w GO111MODULE=on，IDE 内部仍可能用 GOPATH 模式加载项目，导致 go.mod 被忽略、iris 包不进索引。
- 首次启动 GoLand 后，立刻进
Settings → Go → GOROOT，点击+手动指定本地 Go 安装路径（如C:\Go或/usr/local/go），右侧必须显示有效版本号（如go1.25.0） - 在
Settings → Go → Go Modules中，勾选Enable Go modules integration；同时取消勾选Enable GOPATH mode - 若项目已存在
go.mod，右键该文件 →Reload project；若没有，先在终端 cd 到项目根目录，执行go mod init your-module-name，再回 IDE 点Reload
安装 Iris 时别用 go get -u github.com/kataras/iris
这条命令在 Go 1.17+ 默认走 proxy，但部分国内网络环境下仍会卡在 git clone 或拉取间接依赖失败，且 -u 可能升级到不兼容的 v12+（Iris v12 已弃用大部分旧 API，与文档示例不一致）。
- 推荐改用带明确版本的命令：
go get github.com/kataras/iris/v12@v12.2.0（当前稳定版） - 确保
GOProxy已设为可用地址，例如：https://goproxy.cn或https://proxy.golang.org（在Settings → Go → Go Modules里填） - 执行后检查
go.mod是否新增了github.com/kataras/iris/v12行，且go.sum有对应校验值；没有就说明没真正下载成功
运行配置必须选对入口文件，不能只点绿色三角图标
GoLand 默认把 main.go 当作可运行文件，但如果项目结构是 cmd/app/main.go 或用了子模块，直接点编辑器左侧的 ▶️ 会报 no buildable Go source files —— 因为它默认在当前文件所在目录下执行 go run，而没识别到模块根路径。
- 正确做法：点顶部菜单
Run → Edit Configurations…→ 左上角+→ 选Go Build - 在
Run kind下拉中选Package（不是File），然后在Package path填.或完整模块路径（如your-domain/project/cmd/app） - 确保
Working directory是项目根目录（含go.mod的那层），不是main.go所在子目录 - 保存后，用这个新配置运行，才能正确加载
iris依赖并启动 HTTP 服务
代码提示失效？大概率是 vendor 或缓存没刷新
Iris 大量使用接口嵌套和泛型约束（尤其 v12+），GoLand 的索引有时会卡在旧版本符号里，表现为 app := iris.New() 有提示，但 app.Get(…) 没参数提示或跳转失败。
- 先试
File → Invalidate Caches and Restart → Invalidate and Restart，这是最常见解法 - 如果项目启用了
vendor，确认Settings → Go → Vendor中勾选了Enable vendoring support - 检查
go list -m all | grep iris输出是否与go.mod里声明的版本一致；不一致就手动go mod tidy后再 Reload
真正卡住的地方往往不是 Iris 本身，而是 GoLand 对多版本模块路径（比如 /v12 后缀）和 replace 指令的解析延迟——等索引跑完、缓存刷净，提示才会跟上。别急着换编辑器，先让它安静跑两分钟。
