如何在Bazel中通过命令行选项切换Protobuf依赖版本构建

核心思路：通过自定义配置+版本封装隔离不同Protobuf依赖 #

既然WORKSPACE无法动态切换依赖版本，那就先引入所有需要的Protobuf版本并重命名，再通过构建配置和select语法，让目标规则按需关联对应版本的库，同时用工具链保证protoc版本匹配。

步骤1：在WORKSPACE中引入所有需要的Protobuf版本 #

每个版本用独立名称引入，避免依赖冲突：

# WORKSPACE文件
load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")

# Protobuf 3.20.1
http_archive(
    name = "com_google_protobuf_3_20_1",
    urls = ["https://github.com/protocolbuffers/protobuf/archive/v3.20.1.tar.gz"],
    sha256 = "替换为对应版本的sha256校验值",
    strip_prefix = "protobuf-3.20.1",
)

# Protobuf 3.19.4（示例另一版本）
http_archive(
    name = "com_google_protobuf_3_19_4",
    urls = ["https://github.com/protocolbuffers/protobuf/archive/v3.19.4.tar.gz"],
    sha256 = "替换为对应版本的sha256校验值",
    strip_prefix = "protobuf-3.19.4",
)

步骤2：定义版本切换的配置和封装库 #

在项目根目录创建protobuf_config/BUILD文件，封装各版本的Protobuf库，并配置版本切换的条件：

# protobuf_config/BUILD
# 封装3.20.1版本的Protobuf依赖
cc_library(
    name = "protobuf_3_20_1",
    visibility = ["//visibility:public"],
    deps = [
        "@com_google_protobuf_3_20_1//:protobuf",
        "@com_google_protobuf_3_20_1//:protobuf_cc",
    ],
)

# 封装3.19.4版本的Protobuf依赖
cc_library(
    name = "protobuf_3_19_4",
    visibility = ["//visibility:public"],
    deps = [
        "@com_google_protobuf_3_19_4//:protobuf",
        "@com_google_protobuf_3_19_4//:protobuf_cc",
    ],
)

# 定义版本切换的配置开关
config_setting(
    name = "use_3_20_1",
    flag_values = {"//:protobuf_version": "3_20_1"},
)

config_setting(
    name = "use_3_19_4",
    flag_values = {"//:protobuf_version": "3_19_4"},
)

同时在根目录BUILD文件中定义全局版本设置：

# 根目录BUILD文件
package(default_visibility = ["//visibility:public"])

string_flag(
    name = "protobuf_version",
    build_setting_default = "3_20_1",
    values = ["3_20_1", "3_19_4"],
)

步骤3：在目标规则中通过select选择对应版本 #

针对你的C++代码和proto规则，用select关联对应版本的依赖：

# 业务代码BUILD文件
cc_library(
    name = "my_app_lib",
    srcs = ["my_app.cc", "third_party_app.pb.cc"],
    hdrs = ["third_party_app.pb.h"],
    deps = [
        select({
            "//protobuf_config:use_3_20_1": "//protobuf_config:protobuf_3_20_1",
            "//protobuf_config:use_3_19_4": "//protobuf_config:protobuf_3_19_4",
            "//conditions:default": "//protobuf_config:protobuf_3_20_1",
        }),
    ],
)

# 自定义proto_library适配不同版本
proto_library(
    name = "my_proto",
    srcs = ["my_proto.proto"],
    deps = [
        select({
            "//protobuf_config:use_3_20_1": "@com_google_protobuf_3_20_1//:well_known_protos",
            "//protobuf_config:use_3_19_4": "@com_google_protobuf_3_19_4//:well_known_protos",
        }),
    ],
)

cc_proto_library(
    name = "my_proto_cc",
    deps = [":my_proto"],
    # 指定对应版本的protoc工具链，保证生成代码版本匹配
    toolchains = select({
        "//protobuf_config:use_3_20_1": ["@com_google_protobuf_3_20_1//:protoc_toolchain"],
        "//protobuf_config:use_3_19_4": ["@com_google_protobuf_3_19_4//:protoc_toolchain"],
    }),
)

步骤4：配置.bazelrc简化构建命令 #

把版本配置写入.bazelrc，方便快速切换：

# .bazelrc文件
build:protobuf_3_20_1 --//:protobuf_version=3_20_1
build:protobuf_3_19_4 --//:protobuf_version=3_19_4

构建时只需指定对应config：

# 用3.20.1版本构建
bazel build //:my_app_lib --config=protobuf_3_20_1
# 切换到3.19.4版本构建
bazel build //:my_app_lib --config=protobuf_3_19_4

关键注意事项 #

• 第三方提供的.pb.cc文件必须和指定的Protobuf版本严格匹配，否则会出现链接或运行时错误。
• 所有依赖Protobuf的规则都要通过select关联对应版本，禁止混合依赖不同版本。
• 自定义proto生成时，必须指定对应版本的protoc工具链，避免生成代码版本不兼容。

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