Iris 没有官方项目生成命令，因其设计哲学强调轻量、显式、无隐藏行为，不封装 go mod init、不预置路由结构或目录约定，所有项目均需手动初始化纯 Go 模块。
Iris 本身不推荐也不支持“创建项目”这种脚手架式操作——它没有 iris new 或内置模板生成器，所有项目都是手动初始化的纯 Go 模块。
为什么 Iris 没有官方项目生成命令
Iris 的设计哲学是轻量、显式、无隐藏行为。它不封装 go mod init、不预置路由结构、不强制目录约定，避免把用户锁在特定项目形态里。你用 go mod init 初始化，再 import "github.com/kataras/iris/v12"，就完成了“创建”。所谓“项目”，只是你组织代码的方式。
常见错误现象：iris: command not found 或执行 iris new myapp 报错——因为 Iris 根本没提供这个 CLI 工具。
- 不要尝试
go install github.com/kataras/iris/v12@latest试图获得命令行工具 - 不要搜索 “Iris starter template” 并直接 clone 那些年久失修的第三方仓库（很多仍用 v11 接口或已弃更）
- 真正的起点只有两行：
go mod init myapp和go get github.com/kataras/iris/v12@latest
最简可运行 Iris 服务怎么写
不是“Hello World”那种玩具，而是带基本错误处理、端口配置、模块导入规范的生产就绪起点。
立即学习“go语言免费学习笔记（深入）”；
示例中关键点：
-
app := iris.New()必须调用，不能跳过或用iris.Default()（后者已废弃） -
app.Get("/", handler)的handler必须是iris.Handler类型，即func(ctx iris.Context)，不是http.HandlerFunc - 启动必须用
app.Listen(":8080")，不是http.ListenAndServe；Iris 自带 HTTP 服务器，绕过它会丢失中间件、上下文等核心能力
package main
import "github.com/kataras/iris/v12"
func main() {
app := iris.New()
app.Get("/", func(ctx iris.Context) {
ctx.WriteString("OK")
})
app.Listen(":8080")
}
路由参数和中间件怎么配才不踩坑
Iris 路由语法简洁但容易误解：路径中的 :id 是动态参数，*path 是通配符，二者不能混用；中间件注册顺序直接影响执行流，且 UseGlobal 和 Use 行为差异大。
-
app.Get("/user/:id", handler)→ctx.Params().Get("id")取值；写成/user/{id}会 404（那是旧版 v11 语法） -
app.Use(iris.Compression)是全局中间件，对所有路由生效；而app.Get("/api", middleware, handler)中的middleware只作用于该路由 - 如果用了
app.RegisterView，必须确保模板路径是相对os.Executable()的位置，或显式调用app.ConfigureContainer改变查找逻辑，否则热重载时模板找不到
开发阶段如何热重载和调试
Iris 不内置热重载，但可与标准 Go 工具链无缝配合。重点在于避免因缓存或进程残留导致修改不生效。
- 用
air（go install github.com/cosmtrek/air@latest）监听文件变化，配置.air.toml时需排除node_modules和vendor，否则触发频繁重启 - 调试时别用
log.Println打印请求信息——Iris 的ctx.Application().Logger()才能对接其日志级别和格式 - 遇到
panic: interface conversion: interface {} is nil, not string，大概率是模板中访问了未赋值的字段，开启app.Configure(iris.WithOptimizationsDisabled)可获取更准确定位
真正卡住人的往往不是语法，而是 Iris 对 Go 原生机制的“不封装”带来的自由度——比如你可以直接用 net/http.Server 包裹 Iris app，也可以把它当普通 Handler 注入其他框架，但前提是得清楚哪些接口是 Iris 独占的、哪些是标准库的。
