如何将Bazel cc_library的linkopts中-L路径改为相对路径？

问题原因 #

直接在linkopts中写相对路径sdl2/2.28.1/lib无效，核心原因是Bazel的沙盒构建机制：

• 构建时所有依赖文件会被复制到独立的沙盒临时目录，而非直接使用项目原路径
• linkopts中的路径是相对于沙盒工作目录，而非你的BUILD文件所在目录，导致链接器找不到指定路径
• 未通过Bazel的依赖声明（如data、srcs或专用规则）告知Bazel需要处理这个库文件，Bazel不会自动将库文件复制到沙盒

解决方案 #

方案1：使用$(location)宏配合依赖声明 #

通过data字段声明SDL库文件为构建依赖，再用$(location)宏获取沙盒中的正确路径：

cc_library(
    name = "sdl2",
    hdrs = glob(["include/SDL2/*.h"]),
    # 声明SDL库文件为构建依赖，Bazel会将其复制到沙盒
    data = glob(["sdl2/2.28.1/lib/libSDL2-2.0.0.dylib"]),
    linkopts = [
        # 使用$(location)获取沙盒中的库目录路径
        "-L$(location sdl2/2.28.1/lib) -lSDL2-2.0.0",
        "-framework OpenGL"
    ],
    strip_include_prefix = "include",
    visibility = ["//visibility:public"],
)

注意：$(location)后的路径是相对于Bazel工作区根目录的路径，需根据你的项目结构调整。

方案2：使用cc_import规范导入预编译库 #

这是Bazel管理预编译库的推荐方式，无需手动处理路径：

# 导入SDL2预编译共享库
cc_import(
    name = "sdl2_lib",
    shared_library = "sdl2/2.28.1/lib/libSDL2-2.0.0.dylib",
)

cc_library(
    name = "sdl2",
    hdrs = glob(["include/SDL2/*.h"]),
    # 依赖导入的SDL库，Bazel会自动处理链接路径
    deps = [":sdl2_lib"],
    linkopts = ["-framework OpenGL"],
    strip_include_prefix = "include",
    visibility = ["//visibility:public"],
)

这种方式让Bazel完全管理库的依赖和路径，避免手动路径错误，也更符合Bazel的构建规范。

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