Bazel构建C++应用：运行时文件路径异常问题求助

我来分享几个实用的方案，帮你简化程序对运行时文件的访问路径，都是Bazel生态里常用的思路：

1. 使用官方Runfiles库（推荐） #

Bazel提供了专门的runfiles辅助库，能帮你在代码中精准定位到data文件的实际路径，完全不用关心runfiles的目录结构。

首先，在BUILD文件中添加依赖：

cc_binary(
    name = "myapp",
    srcs = [ "main.cpp", ],
    data = glob([ "media/**" ], exclude = [ "media/BUILD", "media/.keep" ]),
    deps = ["@bazel_tools//tools/runfiles:runfiles"],
)

然后在C++代码中使用这个库来获取文件路径：

#include "tools/runfiles/runfiles.h"
#include <iostream>
#include <string>

int main() {
    std::string error_msg;
    auto runfiles = bazel::tools::runfiles::Runfiles::Create(&error_msg);
    if (!runfiles) {
        std::cerr << "初始化runfiles失败: " << error_msg << std::endl;
        return 1;
    }

    // 这里的路径格式是：<工作空间名称>/<文件路径>，默认工作空间是__main__
    std::string media_file_path = runfiles->Rlocation("__main__/media/your_image.png");
    std::cout << "媒体文件路径: " << media_file_path << std::endl;

    // 接下来就可以用这个路径正常访问文件了
    return 0;
}

这个方案的优势是跨平台、官方维护，不管Bazel后续怎么调整runfiles的目录结构，代码都能稳定工作。

2. 用filegroup简化data文件的路径结构 #

如果你想缩短runfiles里的文件路径，可以通过filegroup的strip_prefix属性去掉不必要的目录前缀，让文件结构更简洁。

比如把media目录下的文件直接暴露到runfiles根目录：

filegroup(
    name = "media_files",
    srcs = glob([ "media/**" ], exclude = [ "media/BUILD", "media/.keep" ]),
    strip_prefix = "media",  # 去掉media目录前缀
)

cc_binary(
    name = "myapp",
    srcs = [ "main.cpp", ],
    data = [ ":media_files" ],
)

这样原本__main__/media/image.png的路径就变成了__main__/image.png，代码里只需要找相对runfiles根的短路径即可。如果想保留部分目录结构，也可以调整strip_prefix的值，比如strip_prefix = "media/subdir"。

3. 用包装脚本复制文件到预期路径 #

如果你的程序已经硬编码了文件路径（比如直接读取当前目录下的media文件夹），不想修改代码的话，可以写一个shell包装脚本，先把runfiles里的文件复制到程序预期的位置，再启动程序。

首先拆分BUILD目标：

# 编译核心程序
cc_binary(
    name = "myapp_core",
    srcs = [ "main.cpp", ],
    data = glob([ "media/**" ], exclude = [ "media/BUILD", "media/.keep" ]),
)

# 包装脚本作为最终运行目标
sh_binary(
    name = "myapp",
    srcs = [ "run_myapp.sh" ],
    data = [ ":myapp_core" ],
)

然后编写run_myapp.sh脚本：

#!/bin/bash

# 创建程序预期的media目录
mkdir -p ./media
# 复制runfiles里的media文件到当前目录
cp -r "$0.runfiles/__main__/media/"* ./media/
# 启动核心程序
"$0.runfiles/__main__/myapp_core"

这个方案的缺点是会复制文件，增加启动时间，适合文件体积小、不想改代码的场景。

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