go get 命令易失败主因是v12+模块必须显式带/v12路径和版本（如@v12.2.3或@latest），否则解析卡在旧版；go get -u会误升其他依赖，应避免；需确保import路径、go.mod初始化及缓存清理。
go get 命令容易失败，不是网络问题，而是模块解析逻辑变了——v12+ 版本必须显式指定 @latest 或具体标签，否则 Go 模块系统会卡在旧版依赖树里。
用 go get -u 会出错，改用 go get 加明确版本
常见错误现象：go get github.com/kataras/iris 报错 “no matching versions” 或拉到 v11.x（已废弃）；go get -u 更危险，可能把项目里其他依赖也强行升级。
- 正确写法：
go get github.com/kataras/iris/v12@latest - 若需稳定控制，推荐锁定小版本：
go get github.com/kataras/iris/v12@v12.2.3（查最新发布见 GitHub Releases） - 执行前确保
go.mod已初始化（go mod init your-project-name），否则模块路径无法解析
国内环境下载慢？换源或跳过代理更可靠
Go 官方 proxy（proxy.golang.org）在国内常超时或返回 403，但盲目设 GOPROXY 可能引入镜像同步延迟或不兼容版本。
- 临时加速：运行
export GOPROXY=https://goproxy.cn,direct（Linux/macOS）或set GOPROXY=https://goproxy.cn,direct（Windows CMD） - 更稳妥的做法是关掉 proxy，让
go get直连 GitHub：export GOPROXY=direct，再配git config --global url."https://github.com/".insteadOf "https://github.com/"（避免 SSH 问题） - 如果公司内网禁 GitHub，可先在能联网机器上
go mod vendor，再把vendor/目录带进去
安装后 iris.New() 报错 “undefined”？检查导入路径和模块清理
典型报错：undefined: iris.New 或 cannot find package "github.com/kataras/iris"，多数因残留旧版缓存或路径不匹配。
- 确认 import 是
"github.com/kataras/iris/v12"，不是"github.com/kataras/iris"（v12 要带/v12） - 删掉
$GOPATH/pkg/mod/cache/download/github.com/kataras/下的iris文件夹，再重试 - 如果之前用过
go get github.com/kataras/iris（无 /v12），必须先go get -u github.com/kataras/iris/v12@latest，再go mod tidy清理旧引用
真正卡住的地方往往不是“怎么装”，而是 go.mod 里残留的旧路径、IDE 缓存没刷新、或者 IDE 自动补全仍指向 v11 的 stub。装完跑不通，先 go list -m all | grep iris 看实际加载的是哪个版本。
