要快速搭建基于Iris框架的MVC Web项目，必须依次完成框架安装、目录结构初始化、控制器注册与模板配置四步；缺一不可，否则会报controller not found或view not registered错误。
要快速搭建一个基于Iris框架的MVC模式Web项目，必须先完成框架安装、目录结构初始化、控制器注册与模板配置四步核心操作，缺一不可，否则启动时会报controller not found或view not registered错误。
初始化项目并安装Iris v12
在终端中执行：go mod init myapp 创建模块；接着运行 go get github.com/kataras/iris/v12@latest 安装最新稳定版。注意：若本地已存在旧版kataras目录，【务必先删除 $GOPATH/pkg/mod/cache/download/github.com/kataras 目录下所有 iris 相关缓存】，否则可能因版本冲突导致Assets undefined等编译错误。
创建标准MVC目录结构
手动建立以下层级（大小写敏感，路径名不可简写）：
./datamodels → 存放结构体定义（如book.go）./repositories → 数据访问逻辑（如book_repository.go）./services → 业务处理层./web/controllers → 控制器文件（如hello_controller.go）./web/views → HTML模板文件（如index.html）
这五级目录是Iris MVC识别依赖注入和自动路由映射的前提，漏建任一层都会导致mvc.New()无法正确解析控制器上下文。
编写入口文件main.go
第一步：导入必要包
import ( "github.com/kataras/iris/v12" "github.com/kataras/iris/v12/mvc" "myapp/web/controllers")
第二步：构建App并配置视图
app := iris.New()app.Logger().SetLevel("debug")app.RegisterView(iris.HTML("./web/views", ".html"))
第三步：注册MVC应用实例
mvc.New(app.Party("/")).Handle(new(controllers.HelloController))
⚠️ 注意：此处Party("/")表示根路由组，若写成Party("/api")，则所有控制器方法将自动挂载到/api/*路径下，不可逆改——必须同步调整控制器内BeforeActivation或前端请求路径。
定义HelloController并启用HTTP方法映射
在./web/controllers/hello_controller.go中写入：
package controllersimport "github.com/kataras/iris/v12/context"type HelloController struct{}func (c *HelloController) Get() string { return "Hello, MVC!" }func (c *HelloController) GetIndex() string { return "Index page" }
Iris会自动将Get映射为GET /，GetIndex映射为GET /index。若需自定义路径，必须使用BeforeActivation回调，例如：
方法一：覆盖默认路径
func (c *HelloController) BeforeActivation(b mvc.BeforeActivation) { b.Handle("GET", "/welcome", "WelcomeHandler")}func (c *HelloController) WelcomeHandler() string { return "Custom welcome!" }
方法二：绑定带参数的路径
b.Handle("GET", "/book/{id:int min(1)}", "GetBookByID")func (c *HelloController) GetBookByID(id int) string { return "Book ID: " + fmt.Sprint(id) }
这一步不做，控制器函数就只是普通Go方法，不会被注册为HTTP处理器。
运行服务并验证路由
执行go run main.go，服务启动后访问http://localhost:8080/应返回Hello, MVC!；访问http://localhost:8080/index应返回Index page；若启用了BeforeActivation中定义的/welcome，则该路径也必须可访问。
