c++中如何使用std::filesystem::relative计算相对路径_c++技巧【实例】

冬伟酱_1736

冬伟酱_1736

2026-01-15

856人浏览

原创

c++oding="utf-8" ?>

std::filesystem::relative() 的第一个参数必须是目标路径(to),第二个是基准路径(from),顺序颠倒会导致错误或异常;from需为存在的绝对路径,且应先词法规整;Windows下须统一盘符大小写并确保同盘。

c++中如何使用std::filesystem::relative计算相对路径_c++技巧【实例】

relative() 函数的输入顺序不能颠倒

std::filesystem::relative 的第一个参数是目标路径(to),第二个是基准路径(from)。如果写成 relative(from, to),结果会完全错误,甚至抛出 std::filesystem::filesystem_error(常见报错:“No such file or directory” 或 “Operation not permitted”)。

它内部依赖 from 路径存在且可访问(至少能解析其父目录层级),但并不要求 to 实际存在。所以你传入一个不存在的文件路径作为 to 是合法的,但若 from 是空字符串、非法路径或不可遍历目录(如权限不足),就会失败。

  • ✅ 正确: fs::relative("/home/user/docs/report.pdf", "/home/user") → "docs/report.pdf"
  • ❌ 错误: fs::relative("/home/user", "/home/user/docs/report.pdf") → 可能返回 "../.." 或抛异常,逻辑反了
  • ⚠️ 注意:from 必须是绝对路径;若传入相对路径(如 "./src"),行为未定义,多数实现直接 throw

路径必须先 normalize 再计算 relative

如果路径含 ".."、"." 或多重斜杠(如 "/a//b/./c/../d"),relative() 不会自动规整——它基于原始字符串结构做路径树比对,容易误判公共前缀。

务必先用 fs::weakly_canonical() 或 fs::canonical()(后者要求路径存在)处理两个参数,或者至少用 fs::path::lexically_normal() 做词法规整:

fs::path to = "/a/b/./c/../d";
fs::path from = "/a/x/y";
auto rel = fs::relative(to.lexically_normal(), from.lexically_normal()); // 安全
// to.lexically_normal() → "/a/b/d"
// from.lexically_normal() → "/a/x/y"
// rel → "../../b/d"

Windows 下盘符和大小写敏感性要特别处理

在 Windows 上,relative() 默认区分盘符(C: vs D:),且不忽略大小写。这意味着:

Windows 服务器运维工具箱
Windows 服务器运维工具箱

Windows 服务器运维工具箱 - 磁盘分析、临时文件清理、IIS 站点管理、批量文件操作、服务状态监控、Windows Update 诊断、实时性能监控、安全审计、注册表启动项审计、磁盘健康检测、网络端口监控、事件日志诊断、已安装程序管理、用户会话监控、计划任务审计、文件共享审计、DNS网卡诊断、SSL证书过期检测、防火墙规则审计、服务崩溃恢复状态、系统文件修复、存储池管理、备份状态检查、Docker容器管理、K8s集群监控。只读分析+安全确认,绝不误删文件,完全免费离线运行。

下载
  • fs::relative("C:/foo/bar.txt", "c:/FOO") 可能失败(取决于运行时库版本),因为 "c:/FOO" 未被自动转为大写盘符 + 标准化路径
  • fs::relative("C:/a/b", "D:/x") 永远抛异常:filesystem_error,提示“paths do not share a common root”

解决方法:手动统一盘符大小写,并确认是否同盘:

fs::path from = "c:/FOO";
fs::path to = "C:/foo/bar.txt";
if (from.root_name() != to.root_name()) {
    throw std::runtime_error("Cannot compute relative path across drives");
}
from = from.lexically_normal().make_preferred();
to = to.lexically_normal().make_preferred();
auto rel = fs::relative(to, from);

替代方案:自己实现更可控的 relative(适用于嵌入式或旧标准)

如果你无法确保 C++17 环境,或需要绕过 relative() 对路径存在的隐式检查(比如生成虚拟路径),可以手写一个仅做词法匹配的版本:

fs::path lexically_relative(const fs::path& to, const fs::path& from) {
    auto t = to.lexically_normal();
    auto f = from.lexically_normal();
    auto t_it = t.begin(), f_it = f.begin();
    while (t_it != t.end() && f_it != f.end() && *t_it == *f_it) {
        ++t_it; ++f_it;
    }
    fs::path result;
    for (; f_it != f.end(); ++f_it) result /= "..";
    for (; t_it != t.end(); ++t_it) result /= *t_it;
    return result;
}

这个函数不访问文件系统,纯字符串/路径段操作,适合构建构建脚本、模板路径生成等场景。但它不处理符号链接、挂载点或跨卷限制——这些本来就是 std::filesystem::relative 的职责边界。

真正容易被忽略的是:即使所有路径都合法,relative() 在不同标准库实现(libstdc++ / libc++ / MSVC STL)中对根路径(/ vs C:/)的公共前缀判定逻辑仍有细微差异。线上服务若需强一致性,建议加一层单元测试覆盖典型路径组合。

C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!

相关文章

c++速学教程(入门到精通)
c++速学教程(入门到精通)

c++怎么学习?c++怎么入门?c++在哪学?c++怎么学才快?不用担心,这里为大家提供了c++速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

windows c++ 标准库

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.03

1978

5

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

3324

5

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

2023.10.24

6464

49

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

2023.11.24

6769

6

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

2024.03.22

8274

16

php中定义字符串的方式
php中定义字符串的方式

php中定义字符串的方式:单引号;双引号;heredoc语法等等。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

2024.04.29

13014

11

go语言字符串相关教程
go语言字符串相关教程

本专题整合了go语言字符串相关教程,阅读专题下面的文章了解更多详细内容。

2025.07.29

6779

17

c++字符串相关教程
c++字符串相关教程

本专题整合了c++字符串相关教程,阅读专题下面的文章了解更多详细内容。

2025.08.07

7667

13

常用字符串方法大全
常用字符串方法大全

常用字符串方法大全

2025.08.08

3748

14

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Navicat BI 3 Windows 用户手册
Navicat BI 3 Windows 用户手册

共0课时 | 0人学习

Navicat 18 macOS用户手册
Navicat 18 macOS用户手册

共0课时 | 0人学习