GoLand 在 Apple Silicon 上必须使用原生 ARM64 版本,否则 debug 直接失败;需通过 JetBrains Toolbox 自动安装、验证 Activity Monitor 中进程为 Apple 架构、配置 darwin/arm64 Go SDK,并启用 GoLand 内置 delve 调试器。

GoLand 在 Apple Silicon(M1/M2/M3)上必须用原生 ARM64 版本,否则 debug 会直接失败,且无法通过配置 dlv 或修改 Help > Edit Custom Properties 修复。
下载并安装 JetBrains Toolbox(推荐方式)
直接下载 GoLand .dmg 安装包容易选错架构(比如误下 Intel 版),Toolbox 能自动识别芯片并提供正确版本。
- 访问 JetBrains Toolbox 官网,下载对应 Apple Silicon 的
jetbrains-toolbox-*.dmg(注意文件名含arm64或明确标注 Apple Silicon) - 挂载镜像后,将
JetBrains Toolbox拖入/Applications - 首次运行时,系统可能提示“无法验证开发者”,需右键 App → “打开”绕过 Gatekeeper
- 登录 JetBrains 账户后,点击
GoLand图标旁的Install,Toolbox 会自动拉取GoLand *.* Nightly或最新稳定版的 ARM64 构建(名称中含Apple Silicon)
验证 GoLand 是否运行在原生 ARM64 模式
即使安装了 Apple Silicon 版,某些情况下 macOS 可能仍通过 Rosetta 2 启动 —— 这会导致调试器 dlv 崩溃或断点不生效。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本,适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 打开 Activity Monitor → 切换到
Process Name列 → 找到GoLand进程 - 查看
Kind列:必须是Apple,不是Intel - 若显示
Intel,右键 GoLand 应用 →Get Info→ 取消勾选Open using Rosetta,然后彻底退出 GoLand(菜单栏 →GoLand → Quit GoLand),再重新启动
Go SDK 配置必须匹配芯片架构
GoLand 调试失败的另一个高频原因是 Go SDK 本身是 Intel 编译的,与 ARM64 的 IDE 不兼容。
- 确认已安装 Apple Silicon 版 Go:终端执行
go version,输出应含darwin/arm64(如go version go1.23.1 darwin/arm64) - 若输出为
darwin/amd64,说明你装的是 Intel 版 Go —— 即使在 M 系列 Mac 上也必须重装 ARM64 版。推荐用 Homebrew 安装:arch -arm64 brew install go - 在 GoLand 中:Preferences → Go → GOROOT → 点击
...→ 选择/opt/homebrew/opt/go/libexec(Homebrew ARM64 默认路径)或/usr/local/go(官方 pkg 安装路径) - 不要手动设置
GOROOT为/usr/local/go同时又用 Intel 版 Homebrew 安装的 Go,架构错位会导致go build报cannot execute binary file: Exec format error
调试器 dlv 必须由 GoLand 自动管理
手动 go install github.com/go-delve/delve/cmd/dlv@latest 很可能生成 Intel 二进制,且 GoLand 不会识别该路径。
- GoLand 2023.3+ 默认启用内置
dlv管理:Preferences → Go → Tools → Debugger → 勾选Use built-in delve - 取消勾选
Enable legacy debugging(该模式仅兼容旧版 dlv,且不支持 ARM64 的核心特性) - 首次调试时,GoLand 会自动下载匹配当前 Go SDK 架构的
dlv二进制到~/Library/Caches/JetBrains/GoLand*/delve,无需干预 - 如果调试仍失败,检查
~/Library/Caches/JetBrains/GoLand*/delve/dlv文件权限是否可执行:ls -l ~/Library/Caches/JetBrains/GoLand*/delve/dlv,缺失执行位就运行chmod +x修复
最容易被忽略的一点:GoLand 的「项目 SDK」和「模块 SDK」可能不一致 —— 即使全局设置了正确的 GOROOT,单个项目右键 → Open Module Settings → Project Settings → Project SDK 里仍可能是旧的、错误架构的 SDK。每次新建项目后务必手动核对这里。


















