goland新手需用toolbox安装、首次启动手动指定goroot、新建项目选go模块并等索引完成，再通过边距绿色三角运行main.go；数据库功能依赖go.mod中驱动引入后触发。
GoLand 对新手不算友好，但只要避开几个关键卡点，装完就能写代码、跑起来——不是“等配置完再学”，而是“边配边写”。核心是：别碰 Toolbox 以外的安装方式，别在首次启动时导入旧 IDE 设置，别跳过 GOROOT 指定这一步。
用 Toolbox 安装，别下独立安装包
官网下载的 .exe 或 .dmg 包看似直接，但后续升级、多版本共存、插件同步全得手动操心。Toolbox 是 JetBrains 官方维护的“IDE 管理器”，它自动处理 SDK 绑定、EAP 版本切换、许可证同步，小白最怕的“更新后打不开项目”“插件突然失效”问题基本消失。
- 去 https://www.php.cn/link/633fc6b4e99c858a5e31dae8b4cf70cf 下载 Toolbox，不是 GoLand
- 安装后登录 JetBrains 账号（没账号可免费注册），它会自动识别你是否已有 GoLand 许可或试用期
- 在 Toolbox 里点安装 GoLand，它会自动下载最新稳定版（非 Nightly），并默认勾选“开机自启 Toolbox”和“将 JetBrains 工具添加到 PATH”——这两个都留着
- 装完直接从 Toolbox 启动 GoLand，不要双击桌面图标或从系统菜单进（可能调用旧缓存）
首次启动必须手动指定 GOROOT
GoLand 不会自动认出你本地装的 Go。即使你已运行 go version 成功，IDE 仍会报 Cannot find Go SDK 或提示创建空项目后无法运行 main.go。这不是环境变量问题，是 IDE 没读取系统 PATH，必须人工绑定。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 首次启动进入欢迎页，选“新建项目”，类型选
Go 模块 - 在“新项目”对话框里，
GOROOT字段大概率为空或显示错误路径；点击右侧添加 SDK…→下载…（推荐）→ 选最新稳定版（如1.23.0），它会自动下载并填入路径 - 如果已装 Go，选
添加 SDK…→本地…，然后定位到你的 Go 安装目录（Windows 通常是C:\Go，macOS 是/usr/local/go，Linux 常为/usr/lib/go或~/go） - 确认后点
创建，别关窗口——此时 IDE 才真正加载 SDK 并初始化索引，等右下角状态栏不再显示 “Indexing…”（通常 10–30 秒）再开始写代码
写第一个 main.go 时别忽略边距图标
很多人建完项目就打开编辑器敲 func main()，结果点击 ▶ 运行按钮没反应，或报 no buildable Go source files。根本原因是：GoLand 默认不把新文件当 Go 源码，除非你用对方式创建，或手动标记。
- 在项目根目录上右键 →
新建→Go 文件，类型选简单应用程序（不是“空文件”）——它会自动生成带package main和func main()的模板 - 写完保存（
Ctrl+S），注意编辑器左侧边距：如果出现绿色三角形图标（▶），说明 IDE 已识别为可运行入口；若只有灰色圆点，说明文件未被纳入构建上下文 - 若没图标，检查文件名是否为
main.go（必须小写，不能是Main.go或app.go），且文件在模块根目录下（即有go.mod的同一级） - 点击边距上的 ▶ 图标即可运行，输出会出现在底部
Run工具窗口；别依赖顶部导航栏的全局运行按钮，它只对当前激活的“运行配置”生效，新手还没建过配置时它是哑的
数据库连接失败？先看 go.mod 边距有没有图标
很多教程教你怎么填 JDBC URL、输密码，但小白常卡在第一步：点“新建数据源”后一片灰，连 PostgreSQL 选项都不显示。这是因为 GoLand 的数据库功能是“按需触发”的——它只在检测到项目中引入了数据库驱动（如 github.com/jackc/pgx/v5）时，才激活对应的数据源类型。
- 先确保
go.mod文件里有类似require github.com/jackc/pgx/v5 v5.4.3的行（没有就go get github.com/jackc/pgx/v5） - 保存
go.mod，稍等几秒，再去go.mod文件左侧边距找小图标（像数据库形状的标记），点击它 →新建数据源→PostgreSQL - 这时对话框才真正可用；填
localhost:5432、数据库名、用户密码，点测试连接——如果失败，90% 是本地没跑 PostgreSQL 服务，别折腾 SSL 或 SSH，先用docker run -d -p 5432:5432 -e POSTGRES_PASSWORD=123 postgres起个容器验证流程 - 连接成功后，IDE 才会在右侧
数据库工具窗口列出表结构，支持 SQL 编辑、查询执行——这才是真正能动手的地方
最易被忽略的其实是项目索引状态：刚创建项目或新增依赖后，右下角状态栏显示 “Indexing…” 时，所有代码补全、跳转、重构都不可靠。等它消失再操作，比反复重启 IDE 省半小时。
