Iris 框架不提供 CLI 工具，因此 iris new 会报 command not found；正确起点是 go mod init myapp 和 go get github.com/kataras/iris/v12@latest。
直接上手就能跑，不需要 CLI 工具、不依赖模板生成器、不搞隐藏初始化——Iris 的“快速搭建”就是两行命令 + 一个 main.go 文件。
为什么 iris new 会报 command not found
Iris 根本没提供 iris 命令行工具。所有搜索到的 iris new myapp 或 go install github.com/kataras/iris/v12 都是无效操作，只会得到 command not found 或安装了个空壳。它不是 Gin 或 Fiber 那类带 CLI 的框架，它的“轻量”就体现在这里：不封装 go mod init，不预设目录结构，也不替你写路由入口。
- 正确起点只有两句终端命令：
go mod init myapp和go get github.com/kataras/iris/v12@latest - 别 clone 第三方 “starter template”，很多还卡在 v11，
ctx.Params().Get("id")会 panic - 也别信 “自动配置日志/恢复中间件” 的捷径——
iris.Default()在 v12.2.5 中已标记为 deprecated，文档明确建议用iris.New()显式控制
app.Listen() 和 app.Run() 选哪个
两者都能启动服务，但行为和可扩展性不同。开发阶段图省事用 Listen 没问题；一旦要加 HTTPS、超时控制或自定义 http.Server，必须切到 Run。
-
app.Listen(":8080")是简化封装，等价于app.Run(iris.Addr(":8080"))，适合本地验证 -
app.Run(iris.Addr(":8080"), iris.TLS("cert.pem", "key.pem"))才能启用 HTTPS -
app.Run(iris.Addr(":8080"), iris.WithCharset("UTF-8"))可统一响应头编码，避免中文乱码 - 监听
:80或:443在 Linux 下需 root 权限，非 root 用户直接 panic，错误信息是listen tcp :80: bind: permission denied
路由 handler 类型写错会导致 404 或 panic
Iris 对 handler 类型强校验，写成 http.HandlerFunc 或漏掉 ctx iris.Context 参数签名，编译能过，运行时却进不了逻辑，甚至静默 404。
- 正确签名必须是：
func(ctx iris.Context)，不是func(w http.ResponseWriter, r *http.Request) -
app.Get("/", func(ctx iris.Context) { ctx.WriteString("OK") })—— 这才是有效注册 - 路径参数用
:id，不是{id}（后者是 v11 语法，v12 会 404） - 若要用类型约束，写成
/user/:id:int，min(1)必须紧跟在类型后：/user/:id:int min(1)，顺序错就解析失败
部署时静态文件和模板路径突然 404
本地 ./views 能跑，一扔到 /opt/myapp 就报 template not found，这不是代码 bug，是路径没绝对化。
- 模板注册必须用绝对路径：
app.RegisterView(iris.HTML("/opt/myapp/views", ".html")) - 静态资源同理：
app.HandleDir("/assets", iris.Dir("/opt/myapp/assets")) - 更健壮的做法是把路径抽成配置项，通过
-views="/opt/myapp/views"命令行参数或VIEWS_PATH环境变量传入 - systemd 启动时，
WorkingDirectory不影响 Iris 内部路径解析，它只认你传给iris.HTML()或iris.Dir()的那个字符串
最容易被忽略的是：Iris 不会帮你做任何路径推导或 fallback，所有路径都按字面量处理；另外，v12.2.5 开始，iris.Default() 已废弃，硬用可能在后续小版本中直接移除——显式调用 iris.New() 并逐个 Use 中间件，才是长期可维护的写法。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
