如何用std::filesystem将配置文件引用路径转换为工作目录规范路径？

核心思路 #

应用在工作目录A运行时，配置文件B（绝对路径）中引用的路径C可能是相对B的路径或独立绝对路径。要让A下的应用正确访问目标文件，需先将C转换为无歧义的绝对路径，再基于A生成适配的相对路径（或直接保留绝对路径，视需求选择）。

实现步骤与代码示例 #

下面是基于C++17 std::filesystem的实现代码，包含完整的路径规范化逻辑：

#include <filesystem>
#include <stdexcept>

namespace fs = std::filesystem;

// 参数说明：
// config_file_path_B: 配置文件default.yaml的绝对路径
// path_C: 配置文件中引用的路径（相对B或绝对路径）
// workdir_A: 应用运行的工作目录（可通过fs::current_path()获取）
fs::path normalize_path_for_workdir(const fs::path& config_file_path_B, const fs::path& path_C, const fs::path& workdir_A) {
    try {
        // 1. 获取配置文件所在的目录（B的父目录）
        const fs::path config_dir = config_file_path_B.parent_path();
        
        // 2. 将路径C转换为规范化的绝对路径
        const fs::path absolute_path_C = path_C.is_absolute() 
            ? fs::canonical(path_C) 
            : fs::canonical(config_dir / path_C);
        
        // 3. 转换为相对于工作目录A的相对路径（若需绝对路径可直接返回absolute_path_C）
        return fs::relative(absolute_path_C, fs::canonical(workdir_A));
    } catch (const fs::filesystem_error& e) {
        // 处理路径不存在、权限不足等异常
        throw std::runtime_error("路径规范化失败: " + std::string(e.what()));
    }
}

关键细节说明 #

• fs::canonical的作用：该函数会自动解析符号链接、移除路径中的.//../等冗余部分，生成最简洁的绝对路径，彻底避免路径歧义。如果不需要解析符号链接，可替换为fs::absolute（仅转换为绝对路径，保留冗余部分）。
• 工作目录的获取：如果应用运行时的工作目录就是A，可直接用fs::current_path()作为workdir_A参数，无需手动传入。
• 绝对路径C的处理：若C本身是绝对路径，直接跳过与B目录的拼接，直接规范化后转换为相对A的路径即可。

使用示例 #

假设：

• 工作目录A的绝对路径为/home/user/app
• 配置文件B的绝对路径为/home/user/app/config/default.yaml
• 配置中引用的路径C为../data/image.png（相对B的路径）

调用函数后，会先将C拼接为/home/user/app/config/../data/image.png，经canonical规范化为/home/user/app/data/image.png，再转换为相对于A的路径data/image.png，应用在A目录下即可通过该路径正确访问文件。

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