在Bazel中为cc_library正确使用自定义链接脚本与spec文件

问题根源 #

1. data属性误用：你将链接脚本和spec文件放在data字段中，但data是用于运行时依赖的，Bazel在链接阶段不会自动将这类文件纳入沙箱的构建输入集合。
2. 路径变量选择错误：$(location)返回的是相对于当前规则所在包的路径，而链接命令是在execroot（项目根目录对应的沙箱路径）下执行的，路径解析可能不匹配；$(rootpath)才会返回相对于execroot的路径，和手动执行时的路径一致。
3. 依赖传递缺失：未将文件声明为cc_library的构建输入（如srcs或inputs），导致依赖该库的cc_binary在链接阶段，沙箱中不存在这些文件。

标准Bazel实现方式 #

方式1：直接将文件加入srcs（推荐，适用于文件属于库构建的一部分）

修改some_lib的BUILD配置：

cc_library(
    name = "some_lib",
    srcs = [
        ":lib_files",
        "custom.spec",
        "lscript.ld",
    ],
    hdrs = [":include_files"],
    linkopts = [
        "-Wl,-T,$(rootpath lscript.ld)",
        "-specs=$(rootpath custom.spec)",
    ],
    visibility = ["//visibility:public"],
)

方式2：使用inputs属性（适用于不想将文件纳入库源码集合的场景）

如果需要保留filegroup，可以用inputs显式声明链接阶段需要的输入文件：

filegroup(
    name = "spec_file",
    srcs = ["custom.spec"],
    visibility = ["//visibility:public"],
)

filegroup(
    name = "linker_file",
    srcs = ["lscript.ld"],
    visibility = ["//visibility:public"],
)

cc_library(
    name = "some_lib",
    srcs = [":lib_files"],
    hdrs = [":include_files"],
    inputs = [":spec_file", ":linker_file"],
    linkopts = [
        "-Wl,-T,$(rootpath :linker_file)",
        "-specs=$(rootpath :spec_file)",
    ],
    visibility = ["//visibility:public"],
)

关键说明 #

• $(rootpath)的作用：该变量返回文件相对于execroot的路径，和你手动验证时使用的路径完全一致，确保链接命令在沙箱中能正确找到文件。
• 构建输入声明：srcs或inputs会告诉Bazel，这些文件是构建该库必须的输入，当cc_binary依赖该库时，Bazel会自动将这些文件复制到cc_binary链接阶段的沙箱中，保证文件存在。
• 移除冗余配置：exports_files可以删除，除非有其他规则需要直接引用这些文件；如果不需要共享文件，甚至可以删除filegroup，直接在cc_library中引用文件。

验证步骤 #

1. 执行构建命令：bazel build //some_dir:some_bin
2. 若构建成功，说明配置生效；若仍有问题，检查：
   • 文件路径是否正确（确保custom.spec和lscript.ld在cc_library所在的包目录下）
   • 工具链是否支持从execroot路径读取spec文件（你的手动验证已证明支持）

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