GoLand需手动安装Go并配置PATH，GOROOT必须正确设置，新建项目须勾选Initialize go module，main包文件需位于模块内且含func main()。

GoLand 本身不提供 Go 运行时，go 命令必须独立安装并加入 PATH，否则所有项目创建、依赖下载、运行调试都会失败——这是新手最常卡住的第一步。

确认系统已正确安装 Go 并配置环境变量

GoLand 不会帮你装 Go，它只读取系统 PATH 中的 go 可执行文件。常见错误包括：

• 只下载了 Go 安装包但没运行安装程序（macOS/Linux 需手动解压 + 配置 GOROOT 和 PATH）
• Windows 上安装了 MSI 却勾选了「Add to PATH」但未重启终端或 IDE
• go version 在终端能运行，但在 GoLand 终端里报 command not found（说明 IDE 没继承系统环境）

验证方式：在终端中运行

go version

，再打开 GoLand 内置 Terminal（Alt+F12），同样执行该命令。两者输出必须一致且非空。

在 GoLand 中指定正确的 GOROOT 和 GOPATH

GoLand 1.22+ 默认使用 Go Modules，GOPATH 已非必需，但 IDE 仍需知道 GOROOT 才能索引标准库和启用语法检查。

立即学习“go语言免费学习笔记（深入）”；

linux-performance-analyzer

Linux 性能分析与调优专家，覆盖 CPU、内存、磁盘 I/O、网络、内核参数、编译优化、容器/K8s。适用场景：系统卡顿/高负载、内存不足/OOM/Swap 高、CPU 异常/iowait 高。

下载

• GOROOT：指向 Go 安装根目录（如 /usr/local/go 或 C:\Go），不能指向 bin 子目录
• GOPATH：若你仍用 GOPATH 模式开发（不推荐），需与 go env GOPATH 输出一致；若用 Modules，则可留空或设为任意路径（IDE 不会写入）
• 设置入口：File → Settings → Go → GOROOT（Windows/Linux）或 GoLand → Preferences → Go → GOROOT（macOS）

新建项目时避免选择错误的初始化方式

创建新项目时，GoLand 会弹出「Initialize go module」选项，选错会导致后续 go get 失败或无法识别依赖：

• 勾选「Initialize go module」→ 自动生成 go.mod，推荐用于新项目（Modules 是当前唯一官方支持模式）
• 不勾选 → 项目无 go.mod，IDE 以 GOPATH 模式解析，第三方包无法自动下载，go run 可能报 no required module provides package
• 若已建错，不要手动删 go.mod 后重试；应关闭项目，删掉整个目录，重新 New Project 并勾选初始化

初始化后，检查项目根目录下是否有

go.mod

文件，内容至少包含 module example.com/hello 和 go 1.21（版本号取决于你安装的 Go）。

运行和调试前确保 main 包结构正确

GoLand 能自动识别 main 函数，但前提是文件属于 package main 且位于模块根目录或子目录中——否则 Run Configuration 会提示 No Go files in this directory 或找不到入口。

• 确保至少有一个 .go 文件以

  package main

  开头
• 该文件中必须有

  func main() { ... }

  函数
• 如果代码放在 cmd/myapp/main.go，GoLand 默认不会自动发现；需右键该文件 → Run 'main.go'，或手动添加 Run Configuration，Target 设为 File 并选中该文件
• 调试时若断点灰色不可用，大概率是文件没被编译进当前 build target（检查 package 声明和文件位置）

模块路径、包名、文件位置三者不匹配，是 GoLand 中最隐蔽也最常被忽略的运行失败原因。