goland能直接运行go代码，但需正确配置goroot和sdk；否则报“no sdk configured”或“cannot find package 'fmt'”，根源是ide未连上go环境，而非安装失败。
GoLand 能直接运行 Go 代码，但前提是 GOROOT 和项目 SDK 配置正确；没配好会报 Go SDK is not configured 或 cannot find package "fmt" 这类错误，不是安装失败，而是 IDE 没连上 Go 环境。
下载与安装时必须避开的路径陷阱
安装路径中不能含中文、空格或特殊符号（如 D:\Program Files\GoLand 或 C:\Users\张三\Downloads），否则后续 goland.exe.vmoptions 修改、插件加载、甚至 go mod 命令调用都可能静默失败。官方文档虽未明说，但 JetBrains 工程师在 issue 中多次确认 Windows 下路径含空格会导致 JVM 启动参数解析异常。
- 推荐路径示例：
D:\dev\goland\2024.3（纯英文、无空格、非系统盘） - 安装时勾选「Create Desktop Shortcut」，但不要勾选「Add to PATH」——GoLand 自身不依赖系统 PATH，反而可能干扰你手动配置的
go命令版本 - 安装完成后先别急着启动，检查安装目录下是否存在
bin\goland64.exe（Windows）或bin/goland.sh（macOS/Linux），这是可执行入口，缺失说明解压/安装不完整
首次启动后立即要做的三件事
欢迎界面出现后，跳过导入旧设置（选 Do not import settings），进入主界面第一件事不是写代码，而是确认 Go 环境是否就位。IDE 右下角状态栏若显示 No SDK 或感叹号图标，说明还没连上 Go。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 按
Ctrl+Alt+S打开设置 → 左侧导航到Go | GOROOT - 点击
Add SDK→ 选Local→ 浏览到你本地 Go 安装目录（如C:\Go或/usr/local/go），确保能展开看到src、bin\go.exe（Windows）或bin/go（macOS/Linux） - 点
OK保存后，IDE 会自动扫描标准库，右下角应变为Go 1.22.6（具体版本号）；若仍报错，检查该路径下bin/go version是否能正常输出——GoLand 本质是调用这个命令校验 SDK
新建项目时 Go module 模板的默认行为
选 File | New Project → 类型选 Go Module，此时 IDE 不会自动初始化 go mod init，而是等你第一次保存 .go 文件时才触发。这容易让人误以为项目创建失败。
- 新建项目后，在项目根目录右键 →
New | Go File→ 输入main→ 选Simple application模板 - 保存文件（
Ctrl+S），IDE 底部会弹出提示「Initialize Go module?」→ 点Yes，自动生成go.mod并填充module example.com/hello - 若手动改过模块名，记得同步更新
go.mod第一行，否则go run main.go会因 import 路径不匹配而报cannot load ...: cannot find module providing package
运行按钮失效或显示灰色的常见原因
编辑器左侧边栏出现 ▶ 图标，但点击无反应，或 Run 按钮变灰不可点，大概率是当前文件没被识别为可执行入口。
- 确认文件名是
main.go（不是main_test.go或app.go）且包声明为package main - 确认文件里有且仅有一个
func main()，且无语法错误（IDE 右侧滚动条若出现红色标记，先修复） - 如果用了
//go:build或// +build构建约束，检查当前运行配置的Build tags是否匹配（Run | Edit Configurations→Go Build→Build tags字段） - 临时配置被删光了？检查
Run | Edit Configurations里是否还有Go Build类型的配置；没有就点左上角+→Go Build→Module path填项目根目录路径 →Run kind选Package→Package path填.
最常被忽略的一点：GoLand 的运行逻辑依赖于 go 命令本身是否可用，而不是 IDE 内置解释器。哪怕你配好了 GOROOT，如果终端里执行 go version 报 'go' is not recognized，IDE 在后台调用构建时也会卡住或静默失败——所以务必先在系统终端验证 go 命令可用，再回头配 IDE。
