Golang中tools.go引入gRPC工具包报错：程序不可作为包导入

你遇到的错误是因为这些protoc-gen-xxx工具本质是可执行程序（main包），而非可导入的Go库包，它们没有导出任何可供其他包导入的内容。但tools.go的写法本身是正确的，问题大概率出在环境配置或IDE静态检查的误报上，以下是具体解决步骤：

1. 确认tools.go的写法规范 #

你的tools.go写法符合官方标准，但要确保：

• //go:build tools 和 // +build tools 两行连续放置（兼容Go 1.16+和旧版本）
• 文件放在项目根目录，包声明为package tools

//go:build tools
// +build tools

package tools

import (
    _ "github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway"
    _ "github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-openapiv2"
    _ "google.golang.org/grpc/cmd/protoc-gen-go-grpc"
    _ "google.golang.org/protobuf/cmd/protoc-gen-go"
)

2. 排查环境与执行命令问题 #

• 不要用-tags tools编译主程序：//go:build tools的作用是让Go仅在追踪工具依赖时处理这个文件，正常编译主程序时不要添加-tags tools参数，否则会尝试编译tools包，触发导入错误。
• 确认工具安装路径：执行以下命令重新安装工具，确保它们被安装到GOBIN目录（需确保GOBIN在系统PATH中）：

  go install github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@latest
  go install github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-openapiv2@latest
  go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
  go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
  

• 检查go.mod依赖：执行go mod tidy后，查看go.mod文件，确认这些工具的依赖项已被添加。如果没有，可手动执行go get添加：

  go get github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@latest
  go get github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-openapiv2@latest
  go get google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
  go get google.golang.org/protobuf/cmd/protoc-gen-go@latest
  

3. 处理IDE静态检查误报 #

你的IDE（如VS Code、Goland）标红下划线是因为静态检查工具（如golint、staticcheck）认为这些导入“无用”，但这是tools.go的预期用法，可通过以下方式忽略：

• VS Code Go插件：在settings.json中添加忽略规则：

  "go.lintFlags": [
      "-exclude=unused import"
  ]
  

• Goland：右键标红的导入，选择Suppress for statement，或进入Settings > Editor > Inspections > Go > Unused import关闭该检查项。

4. 验证依赖追踪是否正常 #

执行go list -f '{{.Imports}}' ./tools，如果输出包含这些工具的路径，说明依赖追踪正常，此时即使IDE标红，也不会影响go generate或protoc命令的执行。

内容的提问来源于stack exchange，提问作者Plop'N