协议缓冲区文件中的 go_package 选项有何用途？

Question

我做了一些研究，包括查看谷歌的官方文档，但我找不到该go_package选项用途的良好解释。官方文档声明如下：

该.proto文件应包含 go_package 选项，指定包含生成代码的 Go 包的完整导入路径。

我想我困惑的是导入路径的含义。这听起来更像是导出路径，因为我们要将生成的代码放置在哪里？但是如果我们可以在 期间指定输出路径，为什么我们需要这个呢--go_out=？所以我无法理解为什么需要在 proto 文件中指定导出路径，同时在option go_package?中指定输出路径。

Answer 1

声明生成的代码的预期导入路径对于其他 protobuf 文件了解如何在生成的代码中引用这些类型非常重要。

如果所有 protobuf 定义都在单个.proto文件中声明，则导入路径意义不大，因为它们隐式共享相同的 go 包。如果您开始在多个包中存储/生成 protobuf 文件，它们需要知道如何找到彼此。

查看 protobuf“众所周知”类型就是一个很好的例子：

https://github.com/protocolbuffers/protobuf/blob/master/src/google/protobuf/timestamp.proto

该文件的顶部具有以下包声明：

option go_package = "google.golang.org/protobuf/types/known/timestamppb";

如果我使用另一个 protobuf 文件中使用该消息：

import "google/protobuf/timestamp.proto";

message MyModel {
   google.protobuf.Timestamp ts = 1;
}

我生成的文件MyModel将在文件顶部包含一条导入语句，.pb.go如下所示：

import timestamppb "google.golang.org/protobuf/types/known/timestamppb"