Iris是Go Web框架而非CLI工具，go get仅下载库源码，不生成iris命令；正确用法是在项目中import "github.com/kataras/iris/v12"并调用iris.New()启动服务。
go get 安装 Iris 后没有可执行命令
Iris 是 Go 语言的 Web 框架，不是 CLI 工具，go get 下载的是库源码，不会生成系统级命令（如 iris 或 iris-cli）。你执行 go get -u github.com/kataras/iris/v12 后，在终端敲 iris 报 “command not found”，这完全正常——它压根不提供命令行二进制。
常见误解是把它当成类似 create-react-app 或 django-admin 的脚手架工具。实际上，Iris 的使用方式是：在你的 Go 项目里 import "github.com/kataras/iris/v12"，然后写 app := iris.New() 启动服务。
- 如果你需要快速启动示例，直接运行官方例子：
go run github.com/kataras/iris/v12/_examples/hello-world - 想生成项目骨架？社区无官方 CLI，但可用
go mod init+ 手动写main.go，或参考_examples目录结构 - 误装了第三方包装器（如某些非官方
iris-clinpm 包）？请检查which iris和npm list -g | grep iris，这类工具与框架本身无关
GOBIN 路径未生效导致 go install 工具不可用
有些用户试图用 go install 安装 Iris 相关工具（比如旧版文档提过的 iris-cli），结果发现命令仍找不到，根本原因是 GOBIN 未加入 $PATH。
Go 1.16+ 默认将 go install 的二进制输出到 $GOPATH/bin（或 $GOBIN，若已设置），但这个目录不会自动添加进系统 PATH。
- 确认当前 GOBIN：
go env GOBIN，通常为$HOME/go/bin - 临时生效：
export PATH=$PATH:$(go env GOBIN) - 永久生效（bash/zsh）：
echo 'export PATH=$PATH:$(go env GOBIN)' >> ~/.bashrc && source ~/.bashrc - 验证：
go install golang.org/x/tools/cmd/gopls@latest && which gopls—— 若能定位到，说明路径配置成功
模块化项目中 import 路径解析失败
运行 go run main.go 时报错 cannot find module providing package github.com/kataras/iris/v12，不是安装问题，而是模块路径没对齐。
Iris v12 要求显式使用 /v12 子路径导入，且项目必须启用 Go Modules（GO111MODULE=on）。
- 确保项目根目录有
go.mod文件；若无，先执行：go mod init myproject - 正确导入语句必须是：
import "github.com/kataras/iris/v12"，不是/v11、/iris或无版本后缀 - 如果之前用过老版本，删掉
go.sum并重试go mod tidy，避免缓存污染 - Windows 用户注意路径分隔符：不要手动把
github.com\kataras\iris\v12写进代码，Go 只认正斜杠/
vendor 目录下 Iris 包缺失或版本错乱
项目启用了 go mod vendor，但构建时提示 no required module provides package github.com/kataras/iris/v12，说明 vendor 没包含 Iris 或版本不匹配。
go mod vendor 不会自动拉取间接依赖（indirect）或被 // indirect 标记的包，而 Iris 的某些子依赖（如 golang.org/x/net）常被标记为 indirect。
- 先清理：
rm -rf vendor go.sum - 强制重新解析所有依赖：
go mod edit -dropreplace github.com/kataras/iris/v12（如有 replace） - 再执行：
go mod tidy && go mod vendor - 检查 vendor 是否含
github.com/kataras/iris/v12目录，且其内部go.mod版本号与你require行一致
真正容易被忽略的是：Iris v12 的 go.mod 文件声明了 module github.com/kataras/iris/v12，这意味着它的所有内部 import（如 github.com/kataras/iris/v12/middleware）都必须带 /v12。一旦 vendor 里混入 v11 或无版本路径，编译器会直接拒认。
