iris框架需先装对、配准、跑通三步，否则易卡在版本管理、模板静默失败、路由匹配等细节；go mod未启用或v12后缀缺失致“package not found”，模板路径加载失败因日志级别过低而无提示，party路由与中间件ctx.next()遗漏是404主因。
直接说结论：Iris 框架不是“学了就能上手”，而是“装对、配准、跑通三步不踩坑，后面才顺”。 它的 API 看似简洁，但 iris.New() 和 iris.Default() 行为差异、app.Run() 与 app.Listen() 的兼容性、模板路径加载失败却无报错——这些地方最容易卡住新手。
为什么 go get github.com/kataras/iris/v12 后运行报 “package not found”？
根本原因不是没下载，而是 Go Modules 没启用或版本未锁定。
- 确保项目根目录下有
go.mod文件：没有就先执行go mod init your-project-name - Iris v12 强制要求显式指定版本，不能只写
github.com/kataras/iris；必须带/v12后缀 - 如果用了代理（如 GOPROXY），确认它支持 v12 模块：有些老旧镜像会 fallback 到 v11 或返回 404
- 执行
go list -m all | grep iris查看实际加载的版本，避免本地缓存了错误 commit
iris.HTML("./views", ".html") 加载失败但程序不报错？
这是 Iris 的静默失败设计导致的——模板注册出错时默认不 panic，只在 debug 日志里埋一条提示，而日志级别常被设为 "info" 以下。
- 务必在
app.Run()前加app.Logger().SetLevel("debug") - 检查路径是否相对于
main.go所在目录：比如./views是指执行go run main.go时的当前工作目录，不是main.go文件所在目录 - Windows 下路径分隔符不用改，
./views依然有效；但若用filepath.Join拼接，要确保传入的是字符串字面量而非 runtime 路径 - 模板后缀必须和文件真实扩展名完全一致：
".html"不会匹配index.htm，也不会忽略大小写
路由注册后访问 404，但 app.Get("/", ...) 明明写了？
常见于混用 Party 和根路由、中间件提前终止、或 HTTP 方法不匹配。
-
app.Party("/api")返回的是新路由组，它的.Get()注册的是/api/xxx，不是/xxx；根路由必须用app.Get()显式注册 - 中间件里忘了调用
ctx.Next()（比如自定义鉴权中间件 return 前没加），会导致后续 handler 完全不执行 - Iris 默认不自动处理
OPTIONS预检请求：前端发 CORS 请求时，若没配app.AllowMethods(iris.MethodOptions)或对应路由，就会 404 - 用
curl -X POST测试时，别漏掉-H "Content-Type: application/json"——某些 handler 会因 Content-Type 不匹配而跳过解析
最易被忽略的一点：Iris 的 ctx.View() 和 ctx.JSON() 不是互斥的，但一旦调用 ctx.StatusCode() 或 ctx.StopExecution()，后续所有输出都会被丢弃。调试时别只盯着路由，先确认中间件有没有偷偷 stop 掉上下文。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
