iris项目不能照搬gin或echo目录结构，因其路由注册、中间件挂载和模板渲染机制存在本质差异：依赖显式创建的iris.application实例、严格的注册顺序与作用域隔离（如party嵌套）、模板路径基于运行时目录而非源码目录，且不支持隐式包级共享。
为什么 Iris 项目不能照搬 Gin 或 Echo 的目录结构
Iris 框架的路由注册、中间件挂载和模板渲染机制，跟 Gin 和 Echo 有本质差异。它默认启用 iris.Application 全局实例，UseRouter 和 Party 的嵌套逻辑更强调“作用域隔离”，不是简单把 handler 拆到文件夹里就能跑通。你如果直接把 Gin 的 controllers/ + handlers/ 结构搬过来，大概率会遇到：nil pointer dereference（没初始化 iris.Application）、router not found（Party 路由未被 UseRouter 注册）、或者模板路径找不到（LoadHTMLGlob 默认不递归子目录）。
真正起作用的是「注册顺序」和「实例生命周期」——Iris 的 Application 是单例但非全局变量，必须在 main() 中显式创建并传入各模块，不能靠包级变量隐式共享。
- 所有路由定义必须在
app := iris.New()之后、app.Listen()之前完成 -
Party实例不能跨函数返回后再注册，必须在创建它的上下文中调用.UseRouter() - 模板路径必须是相对于可执行文件运行时所在目录的相对路径，不是源码目录
标准 Iris 项目目录应包含哪几个核心目录
一个可维护的 Iris 项目，建议按功能边界切分，而不是按技术层（比如不设 models/ 或 services/ 这类泛化目录）。实际开发中，最稳定有效的结构是这四个目录：
-
cmd/：只放main.go，负责初始化iris.Application、加载配置、注册路由入口 -
internal/app/：存放所有业务路由逻辑，按领域拆成auth/、api/、admin/等子目录，每个子目录导出一个Setup(app *iris.Application)函数 -
internal/view/：仅放 HTML 模板文件（index.html、layout.html），配合LoadHTMLGlob("internal/view/**/*") -
static/：CSS、JS、图片等静态资源，必须通过app.HandleDir("/static", iris.Dir("./static"))显式挂载
别碰 pkg/ ——Iris 项目里几乎没有需要复用到其他项目的通用逻辑；也别建 config/ 目录放 YAML 文件，Iris 原生不解析 YAML，硬加 viper 只会让启动流程变脆弱。
模板嵌套和静态资源 404 的真实原因
Iris 的 Layout 和 Partial 不是语法糖，它们依赖运行时路径解析。常见 404 并不是路径写错，而是两个隐蔽条件没满足：
-
LoadHTMLGlob必须在app.RegisterView之后调用，否则Layout找不到基础模板 - 静态资源 404 多半因为
app.HandleDir的第二个参数用了绝对路径（如filepath.Abs("./static")），而 Iris 内部会做一次路径拼接，导致最终路径变成/static/static/css/main.css - 前端刷新页面 404？不是前端路由问题，是 Iris 没配 fallback：必须手动加
app.Get("/{path:path}", func(ctx iris.Context) { ctx.ServeFile("./static/index.html") })，且这条路由要放在所有 API 路由之后
模板里引用静态资源，统一用 /static/xxx.css，不要用 ./static/ 或 ../static/ ——Iris 不解析相对路径中的点号。
如何让 Iris 项目支持热重载又不破坏路由注册顺序
Iris 本身不提供热重载，强行用 air 或 fresh 会导致 app 实例重复初始化，进而触发 UseRouter 多次注册，出现 panic：router already registered。真正可行的方案只有两种：
- 开发期改用
iris.Tester写集成测试，每次改代码就跑go test -run TestMyHandler，比刷新浏览器还快 - 坚持用
air的话，必须把app := iris.New()和所有Setup()调用都包进一个工厂函数，例如func NewApp() *iris.Application，然后在air的配置里指定main包为入口，避免全局变量残留 - 永远不要在
init()函数里注册任何路由或中间件——Iris 的init阶段无法访问app实例
最常被忽略的一点：Iris 的 Party 不是线程安全的，如果你在多个 goroutine 里并发调用 myParty.Get()，即使没 panic，路由也可能漏注册。所有路由定义必须在主线程同步完成。
