Mac上安装GoLand前必须确认三件事：终端执行go version能正常输出版本号；确认shell为/bin/zsh（Catalina后默认）；通过JetBrains Toolbox或官网.dmg手动安装，勿用第三方打包器。
Mac 上安装 GoLand 前必须确认的三件事
GoLand 不是独立运行的工具，它依赖系统级的 Go 环境和正确的 Shell 配置。跳过检查直接装，大概率遇到 go command not found 或新建项目时 SDK 识别失败。
- 终端里执行
go version必须能正常输出（如go version go1.26.0 darwin/arm64），否则先装 Go，别碰 GoLand - 确认你用的是
zsh（macOS Catalina 及之后默认）：运行echo $SHELL，输出应为/bin/zsh；如果是/bin/bash，后续配置文件要改用~/.bash_profile - GoLand 官方不提供“一键安装包”，必须通过
JetBrains Toolbox或官网下载 .dmg 手动安装 —— 直接双击 .dmg 拖进 Applications 是最稳妥方式，别信第三方打包器
用 Toolbox 安装 GoLand 的实际操作要点
Toolbox 是 JetBrains 推荐的管理方式，但它在 Mac 上有几个隐藏行为容易导致路径混乱。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 安装后 GoLand 的真实二进制路径不是
/Applications/GoLand.app/Contents/MacOS/goland，而是由 Toolbox 动态生成的沙盒路径，比如~/Library/Caches/JetBrains/GoLand2024.3/bin/goland—— 这会影响终端启动或脚本调用 - 首次启动 Toolbox 后，它会在
~/.local/share/applications/写一个jetbrains-goland.desktop文件（Linux 风格），Mac 上其实不生效，不用管 - 如果想从终端直接运行
goland命令，需手动软链：ln -s "/Users/yourname/Library/Application Support/JetBrains/Toolbox/apps/GoLand/ch-0/bin/goland.sh" ~/bin/goland，再确保~/bin在PATH中
GoLand 启动后立即要做的三步 SDK 配置
新装 GoLand 第一次打开项目时，默认找不到 Go SDK，这不是 bug，是设计如此 —— 它不会自动读取 $GOROOT 或扫描系统路径。
- 创建新项目或打开已有项目后，点击 File → Project Structure → Project → Project SDK，点
+→Go SDK→Add SDK → Go SDK - 路径不要选
/usr/local/go（这是 pkg 安装方式的默认路径），而要选/usr/local/go/bin/go的上层目录，即/usr/local/go；如果你用 Homebrew 装的 Go，路径通常是/opt/homebrew/opt/go/libexec - 勾选
Use PATH environment variable to detect GOPATH，避免手动填错$GOPATH；GoLand 会自动从 shell 环境读取，所以务必确认source ~/.zshrc已执行且go env GOPATH输出正确
常见报错和对应修复动作
这些错误几乎都集中在环境变量加载时机和 IDE 启动方式上，跟 GoLand 本身关系不大。
-
cannot find package "fmt"或类似标准库缺失：说明 Go SDK 路径没设对，或者选了/usr/local/go/bin这种错误子目录 —— 正确路径必须是包含src/和pkg/的根目录 -
go mod download failed: Get \"https://proxy.golang.org/...\": dial tcp: lookup proxy.golang.org: no such host：GoLand 默认用系统代理，但国内网络下必须手动配置镜像源，在Settings → Go → Modules里填入https://goproxy.cn,direct（注意逗号后不能有空格） - 终端能
go run，但 GoLand 里点运行按钮没反应：检查右上角运行配置是否选的是Go Build而非Go Test或其他模板；另外确认Run → Edit Configurations → Templates → Go Build → Working directory是当前项目根目录，不是$ProjectFileDir$的模糊值
~/.zshrc，之后改环境变量、开新终端、甚至重启 IDE 都不会自动重载。最容易被忽略的是：用 Spotlight（Cmd+Space）启动 GoLand 时，它根本不会加载你的 shell 配置，必须从终端执行 open -a GoLand 或提前用 Toolbox 启动，才能确保环境变量就位。 
