能安装Iris,但必须用Go Modules:先go mod init初始化模块,再go get github.com/kataras/iris/v12@latest,导入时必须带/v12后缀,验证需运行含正确导入的main.go并访问/ping。

没设 GOPATH 或 GOBIN 也能装 Iris,但必须用 Go Modules 方式,否则 go get 会失败或装到错误位置。
为什么 go get github.com/kataras/iris/v12 会报错“cannot find module”
Go 1.16+ 默认启用模块模式,但如果你在非模块目录下运行 go get,且没初始化 go.mod,Go 会拒绝写入 GOPATH(尤其 GOPATH 未设置时)。错误典型提示是:go: go.mod file not found in current directory or any parent directory。
- 不是 Iris 的问题,是 Go 工具链对模块路径的强制要求
- 不依赖
GOPATH,但依赖当前目录存在或能生成go.mod - 即使
GOPATH为空或未声明,只要开启模块,go get就只写入go.mod和go.sum,不碰文件系统全局路径
正确安装步骤(零环境变量前提)
只需三步,全程不查 GOPATH,不配 GOBIN:
- 新建项目目录,进入:
mkdir myapp && cd myapp - 初始化模块:
go mod init myapp(模块名可任意,不需对应域名) - 拉取 Iris:
go get github.com/kataras/iris/v12@latest(注意末尾/v12和@latest,v12 是必需的导入路径后缀)
执行完你会看到生成了 go.mod(含 require github.com/kataras/iris/v12)和 go.sum。后续 go run main.go 会自动解析依赖。
常见踩坑点:导入路径写错、版本别名混淆
Iris v12 要求严格匹配模块路径,任何拼写偏差都会导致编译失败:
- ❌ 错误导入:
import "github.com/kataras/iris"(缺/v12)→ 报错:cannot find package "github.com/kataras/iris" - ✅ 正确导入:
import "github.com/kataras/iris/v12" - 如果用了
go install想装 CLI 工具(如iris-cli),必须显式指定-modfile或确保在模块根目录,否则因无go.mod上下文而失败 -
go get -u在模块模式下已弃用,改用go get更安全@upgrade
验证是否真装好了(不靠 ls $GOPATH)
别翻 GOPATH/src——它根本不会被写入。验证方式只有一种:
- 写一个最小
main.go:
package main
import "github.com/kataras/iris/v12"
func main() {
app := iris.New()
app.Get("/ping", func(ctx iris.Context) {
ctx.WriteString("pong")
})
app.Listen(":8080")
}
- 运行:
go run main.go - 访问
http://localhost:8080/ping,返回pong即成功 - 此时
go list -m all | grep iris应输出带版本号的一行,比如github.com/kataras/iris/v12 v12.2.0
模块缓存实际存在 $GOCACHE 或 $HOME/go/pkg/mod 下,但你完全不需要也不应该手动操作那里——Go 工具链自己管。











