非Go Modules模式下Iris安装核心障碍是网络被墙和Git缺失；执行go get需加-v确认进度，缺golang.org/x依赖时应手动克隆GitHub镜像；测试路由须在app.Build()前注册，handler可借httptest模拟上下文调用。
非 Go Modules 模式下，Iris 框架测试环境安装的核心障碍是网络依赖和 Git 环境缺失，不是框架本身难装。
go get -u github.com/kataras/iris 卡住或报错
执行 go get -u github.com/kataras/iris 时终端无响应，大概率不是失败，而是后台静默下载中。加 -v 可确认进度：go get -u -v github.com/kataras/iris。若仍卡在某个 golang.org/x/... 路径（如 golang.org/x/net/publicsuffix），说明被墙——Go 官方域名在国内无法直连。
- 先检查是否装了 Git：
git --version；没装就装，CentOS 执行sudo yum install git，Windows 装 Git for Windows 并勾选 “Add to PATH” - 手动补全三个关键依赖：进入
$GOROOT/src/golang.org/x/（若目录不存在则创建），依次执行：git clone https://github.com/golang/net.git、git clone https://github.com/golang/text.git、git clone https://github.com/golang/crypto.git - 不推荐用
GO111MODULE=off go get强制关模块——Iris v12+ 已深度依赖模块语义，关了反而触发更多路径解析错误
测试用的 handler 怎么脱离 HTTP server 运行
Iris 的 handler 是 func(iris.Context) 类型，可直接调用，无需启动服务。关键是不能用 &iris.Context{} 手动 new，必须通过应用实例构造上下文。
- 用
app := iris.New()创建 app 后，再调app.NewContext(w, req)，其中w是httptest.NewRecorder()，req是httptest.NewRequest("GET", "/path", nil) - 如果 handler 内部用了
c.Session()，必须提前调c.StartSession()，否则 panic - 依赖注入（如 mock DB）需在测试前调
app.ConfigureContainer注册，且每次测试应重置容器状态，避免测试间污染
怎么安全地加 /debug 或 /test 路由只在开发环境生效
Iris 没有内置“条件路由”，靠中间件拦截是错的——路由已注册，只是运行时拒绝，白白消耗 goroutine 和日志噪音。
- 把测试路由写成独立函数，如
registerTestRoutes(app *iris.Application)，并在main()中用os.Getenv("ENABLE_TEST_ROUTES") == "true"包裹调用 - 绝对不要在
app.Run()之后再调app.Get()，会 panic 报cannot register route after server started - 别用模糊环境变量名如
"ENV" == "development"，拼错就失效；明确用"ENABLE_TEST_ROUTES"这类布尔语义键名
最易被忽略的一点：所有测试路由必须在 app.Build() 之前注册完成，否则 iris.Test() 会报 no routes found——它不自动触发构建，而 app.Run() 会隐式调用，但测试时不走这条路径。
