GoLand不能自动识别Go SDK,需手动配置GOROOT并确保go.mod生成;若GOROOT显示红色感叹号,说明未找到Go安装路径,应通过Add SDK下载或手动指定根目录(如C:\Go或/usr/local/go),且main.go必须与go.mod同级才能正常运行。

只要 Go SDK 已安装,GoLand 就能自动识别并帮你完成全部流程,不需要手动配置 GOPATH、不用敲 go mod init、也不用在命令行里运行 —— 点击绿色三角就能看到 "Hello, World!" 输出。
新建 Go Module 项目时 GOROOT 显示红色感叹号
这说明 GoLand 没找到本地 Go 安装路径。常见原因有:Go 未安装;已安装但不在系统 PATH 中;或安装路径含中文/空格。
- 直接点击右侧的
Add SDK→Download,选最新稳定版(如1.22.5),IDE 会自动下载并配置 - 如果想复用已有 Go,选
Local,手动指向GOROOT(Windows 通常是C:\Go,macOS/Linux 一般是/usr/local/go) - 确认后点
Create,项目根目录下应自动生成go.mod文件;若没有,说明模块未初始化成功,需删掉项目重来
右键新建 Go File 时选错模板导致无法运行
新建文件必须选 Simple application,否则生成的是空文件,缺少 package main 和 func main(),运行时报 no main package 错误。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本,适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 右键点击项目根目录(和
go.mod同级的文件夹),不是src或main子目录 - 文件名填
main即可,Go 要求可执行程序入口文件必须是package main,且文件名不强制叫main.go,但惯例如此 - 生成的模板里已有
import "fmt"和fmt.Println(...),改字符串内容保存即可
点击绿色三角没反应或报 cannot find package
这不是代码写错了,而是项目结构或模块识别出了问题。GoLand 的运行逻辑依赖 go.mod 和目录层级。
- 确保
main.go和go.mod在同一级目录下;如果main.go在子目录(如cmd/main.go),默认配置无法识别 - 检查
go.mod第一行是否为module xxx,且后面没有空行或乱码 - 临时解决:右上角运行配置下拉菜单 →
Edit Configurations…→ 新建Go Build→Run kind设为Directory→Directory填项目绝对路径(即含go.mod的那层)
最易被忽略的是:GoLand 默认只信任 go.mod 所在目录及其子目录里的 Go 文件,跨目录引用或放错位置都会让 IDE “看不见” main 函数。别急着调参数,先确认 main.go 和 go.mod 是否真正在同一层。

















