go run 是最轻量的开发调试方式,只需一个含 package main 和 func main() 的 go 文件即可直接执行,不生成二进制、不写磁盘、无需 go.mod,但要求文件必须为 main 包且 main 函数无参数无返回值。

装完 Go 就能跑,不用配 GOPATH、不用建 src 目录、不用 go mod init —— 只要一个 main.go 文件里有 package main 和 func main(),go run main.go 就直接输出结果。
go run 是最轻量的启动方式
开发调试阶段,go run 是首选。它跳过生成二进制、不写磁盘、不依赖模块系统(哪怕没 go.mod),只做编译+立即执行两件事。
-
go run要求文件里必须是package main,且只能有一个func main(),否则报cannot run non-main package或func main must have no arguments and no return values - 多个
.go文件一起跑:比如main.go+utils.go,就写go run main.go utils.go;不能只写go run *.go(shell 展开后顺序不可控,可能漏包) - 如果文件里用了第三方包(如
github.com/sirupsen/logrus),go run会自动下载并缓存到$GOPATH/pkg/mod,但不会生成go.mod—— 这容易导致后续go build失败,因为缺少模块声明
什么时候必须 go mod init
不是“一创建项目就要”,而是当你需要明确依赖版本、要 go build 出可分发的二进制、或引入本地子模块时,才真正需要模块系统。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
- 执行
go mod init myapp后,当前目录成为模块根,go run行为不变,但后续所有go get、go build都会受go.mod约束 - 模块名不一定要是 URL 形式;
go mod init hello完全合法,只是后期推送到 GitHub 时需手动改module行 - 如果已有
go.mod但依赖缺失,运行go mod tidy自动补全,别硬删go.sum—— 否则校验失败,go run会卡在下载阶段
Goland 里跑不起来?先看这三个地方
IDE 配置错位比代码出错更常导致 File is invalid 或 cannot find package 报错。
-
GOROOT必须指向你安装 Go 的真实路径(如/usr/local/go或C:\Go),不是项目目录;Goland 通常能自动识别,但手动改过就容易错 -
Project GOPATH不要设成全局路径(如$HOME/go);新项目建议关掉 “Use GOPATH that is defined in system environment”,改用项目级独立路径,避免和别的项目冲突 - Run Configuration 里选的是
Go Build还是Go Run?前者必须填 “Output directory”,后者不需要;若误选Go Build却没设输出路径,点运行就静默失败
真正卡住的地方往往不是语法或逻辑,而是模块初始化时机和 IDE 缓存状态——改完 go.mod 后,Goland 有时不会立刻重载依赖,手动触发 File → Reload project 比重启更有效。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










