goland不读取~/.zshrc或~/.bash_profile，导致protoc-gen-go未被识别；需在preferences→go→gopath确认路径，并在terminal→environment variables中显式追加$gopath/bin到path，再重启验证。

protoc-gen-go 为什么在 GoLand 里找不到

GoLand 默认不读取 shell 的 ~/.zshrc 或 ~/.bash_profile，所以即使你在终端里能跑通 protoc --go_out=.，GoLand 启动的终端环境可能根本没加载 $GOPATH/bin。这不是 GoLand 的 bug，而是它启动时用的是“干净”的环境变量。

GoLand 中必须手动配置 GOPATH/bin 到 PATH

直接改 GoLand 的 Shell path 不可靠，最稳的方式是进设置里显式注入：

GoLand 2026.1.1

GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。

下载

• 打开 GoLand → Preferences → Go → GOPATH，确认 GOPATH 路径正确（比如 ~/go）
• 进入 Preferences → Tools → Terminal，找到 Shell path 下方的 Environment variables 按钮，点击编辑
• 添加或修改 PATH：在原有值末尾追加 :$GOPATH/bin:/usr/local/bin（注意 macOS/Linux 用冒号，Windows 用分号）
• 重启 GoLand，新开 Terminal，运行 which protoc-gen-go 应返回 ~/go/bin/protoc-gen-go

验证 protoc 和插件是否真被 GoLand 识别

光有 protoc 不够，protoc-gen-go 必须能被 protoc 自动发现——这依赖于命名和 PATH 匹配：

• protoc 在调用 --go_out 时，会按约定查找名为 protoc-gen-go 的可执行文件（不能叫 protoc-gen-go-v1 或带后缀）
• 运行 protoc-gen-go --version 成功，不代表 protoc 就能调用它；要测试真实链路：
  protoc --go_out=. --go_opt=paths=source_relative example.proto
• 如果报错 protoc-gen-go: program not found or is not executable，说明 PATH 没生效，或文件权限不对（chmod +x ~/go/bin/protoc-gen-go）

GoLand 内置 Tools 配置容易忽略的点

如果你用 GoLand 的 External Tools 配置一键生成（推荐），要注意三个硬性条件：

• Program 填 protoc（不是完整路径，除非你非要绝对路径）
• Arguments 必须包含 --go_out=$ProjectFileDir$ 和 --go_opt=paths=source_relative，否则生成文件位置错乱
• Working directory 设为 $ProjectFileDir$，否则 proto_path 解析失败
• 别漏掉 go_package option：.proto 文件里必须有 option go_package = "xxx";，否则生成的包名会退化成目录名，引发 import 冲突

GoLand 对 Protobuf 工具链的感知完全依赖环境变量注入和命名规范，没有“自动检测”机制。PATH 漏一个 /bin、go_package 少一行、插件二进制权限不对——任一环节断掉，都会静默失败，只在生成时抛出模糊错误。