goland 首次安装需以管理员身份运行安装包、避免中文/空格路径、拒绝导入旧设置、手动配置 goroot 和 goproxy,否则将出现 no go sdk found 或模块拉取超时等问题。

GoLand 能直接用官网安装包装好就跑,但跳过环境变量配置或 SDK 指向错误,No Go SDK found 会立刻弹出来卡住新建项目——这不是软件问题,是 GOROOT 和 GOPATH 没对上。
下载安装包后必须以管理员身份运行 .exe
Windows 上双击 GoLand-2025.1.exe 启动安装向导时,如果没右键选「以管理员身份运行」,后续可能无法写入 bin 目录、替换 .vmoptions 文件,或者激活补丁加载失败。很多用户卡在「启动后空白/闪退/提示 JVM 启动异常」,根源就在这一步权限缺失。
- 解压后的安装包目录里,找到
GoLand-2025.1.exe,右键 → 以管理员身份运行 - 安装路径别选 C:\Program Files(尤其带空格或中文路径),推荐
D:\JetBrains\GoLand-2025.1 - 勾选「创建桌面快捷方式」和「将 GoLand 添加到 PATH」(后者方便命令行调用
goland)
首次启动时拒绝导入旧设置,否则 GOROOT 可能被污染
第一次打开 GoLand,它会问「Do you want to import settings from previous versions?」。选「Don’t import」——因为旧版本残留的 GOROOT 或代理配置可能指向已删除的 Go 安装路径,导致新建项目时找不到 SDK,报错 No Go SDK found,且该错误不会自动修复,必须手动重配。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本,适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 点「Don’t import」→ 「OK」→ 进入欢迎页
- 不要急着点「New Project」,先去 Configure → Settings → Go → GOROOT
- 点击「+」添加 SDK,路径必须指向你本地 Go 的
bin上一级,比如C:\Go或D:\go,不是C:\Go\bin - 确认右侧显示「Go version: go1.xx.x」才算识别成功
go env 配置不生效?检查 GOPROXY 和 GO111MODULE 是否写进系统变量
即使 Goland 里 SDK 显示正常,go run main.go 仍可能卡在「fetching module」或报 dial tcp: i/o timeout,说明 Go 命令行本身没走国内代理。Goland 不会自动继承你终端里临时设置的 go env -w,必须让系统级环境变量生效。
- 在 CMD 或 PowerShell 中执行:
go env -w GOPROXY=https://goproxy.cn,direct - 再执行:
go env -w GO111MODULE=on - 重启 Goland(不是仅关闭项目,要彻底退出进程)
- 新建项目时选「Go modules」而非「Empty project」,确保生成
go.mod
中文界面设置要等 IDE 完全加载后再操作
刚启动 Goland 就点右上角小铃铛 →「Enable Chinese」,大概率失败并弹出「Plugin not found」。因为语言插件依赖核心模块加载完成,而首次启动时插件市场还在后台初始化。
- 等左下角状态栏不再显示「Loading plugins…」或「Indexing…」
- 再点右上角 ⚙️ → Settings → Languages & Frameworks → Plugins
- 搜索
Chinese,安装「Chinese (Simplified) Language Pack」 - 安装完点「Restart IDE」,不是「Restart and clear cache」
真正容易被忽略的是:Goland 的 GOROOT 配置只影响 IDE 内部编译和提示,不影响终端里 go 命令的行为;而 go env 设置的是命令行行为。两者要一致,否则你会遇到「IDE 里能跑,终端里报错」或者「终端能跑,IDE 提示找不到包」这类割裂问题。










