使用buf generate生成Protocol Buffers时遇grpc-gateway插件未找到错误

• 你安装的插件不对
  你执行的go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest是用于生成gRPC Go服务端/客户端代码的插件，和报错里的grpc-gateway不是同一个工具。你需要安装的是protoc-gen-grpc-gateway——这是grpc-gateway项目对应的代码生成插件。

• 正确安装grpc-gateway插件
  执行以下命令安装最新版本的插件：

  go install github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@latest
  # 若需要生成OpenAPI文档，可额外安装：
  go install github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-openapiv2@latest
  

• 确保插件在$PATH中
  Go的二进制文件默认安装在$HOME/go/bin（未设置GOPATH时）或$GOPATH/bin，需要确认这个路径已加入系统环境变量：

  1. 检查当前PATH：echo $PATH，查看是否包含上述路径
  2. 临时添加路径（Linux/macOS）：export PATH=$PATH:$HOME/go/bin
  3. 永久生效：将上述export命令添加到~/.bashrc、~/.zshrc等配置文件；Windows则在系统环境变量中编辑PATH添加对应目录

• 验证安装结果
  执行protoc-gen-grpc-gateway --version，如果能正常输出版本信息，说明安装成功。此时再运行buf generate即可解决插件找不到的问题。

• 额外检查buf配置文件
  确认你的buf.gen.yaml配置中正确引用了grpc-gateway插件，示例配置如下：

  version: v1
  plugins:
    - name: go
      out: gen/go
      opt: paths=source_relative
    - name: go-grpc
      out: gen/go
      opt: paths=source_relative,require_unimplemented_servers=false
    - name: grpc-gateway
      out: gen/go
      opt: paths=source_relative
  

内容的提问来源于stack exchange，提问作者Ankit Gupta