无需配置option go_package，通过命令行生成依赖其他proto的protobuf

假设你有如下场景：多个.proto文件存在依赖关系，且所有文件都未定义option go_package，需要通过命令行生成Go语言的Protobuf代码。以下是具体操作步骤：

1. 准备目录与示例文件 #

先明确你的文件结构，比如将所有.proto文件统一放在./proto目录下，依赖文件和目标文件分个子目录：

./
├── proto/
│   ├── common/
│   │   └── common.proto  # 被依赖的基础proto文件
│   └── user/
│       └── user.proto    # 待生成的目标proto文件，依赖common.proto
└── gen/                  # 生成的Go代码输出目录（可提前创建）

示例common.proto内容：

syntax = "proto3";

message CommonInfo {
  string trace_id = 1;
  int64 timestamp = 2;
}

示例user.proto内容（依赖common.proto）：

syntax = "proto3";

import "common/common.proto";  # 路径对应--proto_path指定的根目录下的相对路径

message User {
  string id = 1;
  string name = 2;
  CommonInfo info = 3;
}

2. 核心生成命令 #

使用protoc命令时，关键是指定proto文件查找根目录和Go代码输出规则，有两种常用方式：

方式一：按源文件相对路径生成（推荐简单场景） #

这种方式会让生成的Go文件路径与proto文件的相对路径完全一致，无需手动指定每个文件的包路径：

protoc --proto_path=./proto \
  --go_out=./gen \
  --go_opt=paths=source_relative \
  ./proto/common/common.proto ./proto/user/user.proto

参数解释：

• --proto_path=./proto：告诉protoc从./proto目录开始查找所有import的proto文件，确保能找到依赖的common.proto
• --go_out=./gen：指定生成的Go代码输出到./gen目录
• --go_opt=paths=source_relative：强制生成的文件路径与proto源文件的相对路径匹配，自动根据目录结构生成包名

方式二：手动指定包路径（适合Go模块项目） #

如果你的项目使用Go模块，希望生成的代码包路径与模块路径一致，可以通过--go_opt=M<proto文件路径>=<目标包路径>来逐个指定：

protoc --proto_path=./proto \
  --go_out=./gen \
  --go_opt=Mcommon/common.proto=github.com/your-username/your-project/common \
  --go_opt=Muser/user.proto=github.com/your-username/your-project/user \
  ./proto/common/common.proto ./proto/user/user.proto

这种方式下，生成的Go代码中会使用你指定的包路径进行import，完全符合Go模块的规范。

3. 注意事项 #

• 必须将所有依赖的proto文件所在的目录加入--proto_path，否则protoc会报错找不到import的文件
• 建议一次性处理所有相关的proto文件（包括依赖的），避免因版本不一致导致的兼容性问题
• 确保已安装protoc和protoc-gen-go工具，可通过protoc --version和protoc-gen-go --version验证

内容的提问来源于stack exchange，提问作者Vikash Mishra