goland运行单个.go文件必须同时满足package main和func main()，缺一不可；快捷键为ctrl+shift+f10（win/linux）或⌃⇧r（macos），失败常见原因包括包名错误、缺失main函数、goroot未配置或模块路径异常。
GoLand 运行单个 .go 文件的硬性前提
不能直接点绿色三角就跑通——GoLand 的「Run」动作不是解释器，它严格依赖 Go 的构建规则。想让一个文件被识别为可执行入口，必须同时满足两个条件：package main + func main()。缺一不可，大小写敏感，且不能藏在其他包里。
常见错误现象：
- 点击运行后弹出
cannot run non-main package - 右键菜单里没有
Run 'xxx.go'选项 - 绿色三角图标变灰，鼠标悬停提示 “No run configuration”
实操建议：
- 确认文件第一行是
package main（不是Package main、package Main或package utils） - 检查是否真有
func main() { ... }，且不在注释里、没被条件编译屏蔽（比如// +build ignore） - 不要把
main.go放在internal/或cmd/xxx/子目录下却不配置 module 路径——GoLand 默认只认当前文件所在模块根目录
Ctrl+Shift+F10 失效时该查什么
这个快捷键是 GoLand 最快的单文件运行方式，但失败原因往往和 IDE 配置或项目结构强相关，不是代码写错了那么简单。
容易踩的坑：
-
GOROOT或Go binary路径未正确设置：进File > Settings > Go > GOROOT，确认路径指向真实安装目录（如D:\Program Files\Go），且Go binary是go.exe（Windows）或go（macOS/Linux） - 启用了 Go Modules 但当前目录无
go.mod，且上层目录存在干扰性的go.mod——GoLand 可能误入别的 module 上下文，导致导入失败 - 文件有编译错误（比如未使用的变量、拼错的函数名），IDE 会在运行前做静态检查，直接禁用运行按钮
- 多模块项目中，当前文件不在激活的 module 根目录下，
go run会报no required module provides package xxx
验证方法：在终端手动执行 go run xxx.go，如果也失败，问题一定出在代码或模块结构；如果终端能跑通而 IDE 不行，基本就是 IDE 的 Go Modules integration 没勾选或 GOPATH/GOROOT 错了。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
右键菜单里没有 Run 'xxx.go' 怎么办
这不是 IDE 卡顿或 bug，而是 GoLand 在编辑器左侧装订线或右键上下文里做了“语义过滤”：只有当光标落在 func main() 函数体外（比如文件顶部、空行、注释区），右键才显示运行选项；一旦光标进到 main 函数体内，右键菜单就只剩 Run 'TestXXX' 或 Debug 等，不再提供单文件运行。
为什么这样设计？因为 GoLand 把“在函数内右键”默认理解为你想运行测试或调试该函数，而不是整个文件。
实操建议：
- 把光标移到
func main()大括号 外面（哪怕只是换一行空行），再右键 - 或者直接点编辑器左侧行号边的绿色三角图标（装订线上的
Run Application图标），它不依赖光标位置 - 别在
main函数内部右键试图运行——此时看到的是Run 'main' in xxx.go，但 Go 不允许一个包里有多个main函数，会报错
用 go run 命令替代 IDE 运行的注意事项
当你在终端敲 go run main.go，它比 IDE 更“宽容”，但也更易埋雷。
关键差异：
- 单文件没问题；但若
main.go依赖同目录下handler.go，只写go run main.go会报undefined: someFunc——必须显式列出所有文件：go run main.go handler.go utils.go - Windows cmd 不支持
go run *.go，bash/zsh 才行；想跨平台偷懒，得写脚本或改用go run .（但要求当前目录有go.mod且是 module 根） -
go run每次都重新编译临时二进制，不缓存，对中大型项目明显卡顿；而 GoLand 的 Run 配置如果设成Go Build并指定Out Directory，实际走的是go build -o，可复用输出 -
go run会自动忽略_test.go，但不会跳过helper.go这类辅助文件——列不全就漏依赖
最稳妥的做法：开发阶段用 IDE 的 Ctrl+Shift+F10（确保前提满足），上线前用 go build 验证最终产物；别把 go run 当成万能胶，尤其在多人协作项目里，module 结构和文件依赖关系稍一混乱，命令就失效。
