必须启用Go Modules、配置代理、保持路径干净；否则go get github.com/kataras/iris/v12会卡住或报错。需确认go命令可用、GO111MODULE=on、GOPROXY正确设置，且项目路径合法无空格中文。
装 Iris 前，Go 环境必须满足模块模式（Go Modules）全启用、代理可用、路径干净这三点；否则 go get github.com/kataras/iris/v12 会卡住、校验失败或报 no required module provides package。
go version 不识别？先确认 PATH 和 GOROOT 是否真实生效
这是最常被误判为“Iris装不上”的起点——其实 go 命令根本没进系统路径。
- Windows：运行
where go，若无输出，说明%GOROOT%\bin没加进系统环境变量Path；检查安装时是否勾选 “Add Go to PATH”，没勾就手动把C:\Go\bin（或你实际安装路径）加进去 - macOS/Linux：运行
which go，若为空，检查~/.zshrc或~/.bash_profile是否写了export PATH=$PATH:/usr/local/go/bin，改完必须新开终端，source不够用 - 别信
go env GOROOT的返回值——如果go都跑不起来，这个值可能是错的；以where go或which go的路径反推GOROOT更可靠
go mod init 失败或 go get 卡在 resolving...？GO111MODULE 和 GOPROXY 必须设对
Iris 是模块化项目，依赖 go.mod 和远程代理下载，关掉模块或没配代理，命令就等于废掉。
- 执行
go env -w GO111MODULE=on—— Go 1.16+ 虽默认开启，但旧 shell、IDE 内置终端或公司镜像脚本可能把它关成off，go env GO111MODULE输出必须是on - 国内必须配代理：
go env -w GOPROXY=https://goproxy.cn,direct；验证用go env GOPROXY，输出应严格匹配 - 如果公司内网不允许外连，设为
go env -w GOPROXY=direct，但得提前用go mod vendor把 Iris 及其依赖打包进来 -
go get github.com/kataras/iris/v12必须在项目根目录下执行，且该目录已运行过go mod init myapp（模块名不能叫main）
go run main.go 报 no required module provides package？项目路径和模块名不匹配
这不是 Iris 的问题，是 Go 工具链找不到模块边界，常见于路径含中文、空格，或 go mod init 时没指定合法模块路径。
- 项目目录名必须是纯英文、无空格、无特殊字符（如
my-iris-app可，我的项目或iris demo不可） -
go mod init的参数必须是合法导入路径：推荐用go mod init github.com/yourname/my-iris-app，避免用example.com这类占位符（某些工具链校验更严） -
main.go和go.mod必须在同一级目录；如果在D:\projects\iris下初始化，就别在D:\根目录下执行go run - 曾误操作过？删掉当前目录下的
go.mod和go.sum，换干净路径重试
VS Code 里 Iris 代码没提示、调试灰掉？缺的是 gopls，不是 Iris
Iris 本身不提供语言支持，所有补全、跳转、诊断都靠 gopls。插件提示 “Installing tools…” 卡住，90% 是代理或模块模式没开。
- 先确保
GO111MODULE=on和GOPROXY已设好，再重启 VS Code（不是 Reload Window，是彻底退出重开） - 手动触发安装：
Ctrl+Shift+P→ 输入Go: Install/Update Tools→ 全选，重点确认gopls和dlv成功安装 - 如果手动
go install golang.org/x/tools/gopls@latest成功，说明网络和模块配置已通，插件后续会自动补全其余工具 - 注意：
$GOPATH/bin必须在系统PATH中，否则 VS Code 启动时找不到gopls；Windows 用户尤其容易漏掉这步
真正卡住的地方往往不在 Iris 文档里写的那行 go get，而在于 go env 输出里那几行看似无关紧要的配置——尤其是 GO111MODULE 和 GOPROXY 的实际值，以及终端是否真的加载了最新环境变量。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
