C++如何检查一个路径是文件还是文件夹

云静小哥_1207

云静小哥_1207

2026-06-01

679人浏览

原创

c++17起应优先使用std::filesystem::is_regular_file()和is_directory()判断文件类型,二者均要求路径存在且可访问,否则抛异常;需先用exists()检查存在性,再分情况处理文件、目录及其他类型。

c++如何检查一个路径是文件还是文件夹

用 std::filesystem::is_regular_file() 和 std::filesystem::is_directory() 判断类型

标准库从 C++17 开始提供 std::filesystem,这是最直接、跨平台的方案。它不依赖系统 API,也不需要手动处理符号链接歧义(默认会解引用)。

关键点:两个函数都要求路径存在且可访问,否则抛出 std::filesystem::filesystem_error。务必捕获异常或先用 exists() 检查。

  • is_regular_file(path) 返回 true 仅当是普通文件(不含目录、socket、设备节点等)
  • is_directory(path) 对目录返回 true,对符号链接指向的目录也返回 true(除非加 std::filesystem::symlink_option::no_follow)
  • 若路径不存在,两者都返回 false —— 所以不能单靠 false 推断“是另一个类型”,必须结合 exists()
#include <filesystem>
namespace fs = std::filesystem;

fs::path p = "/tmp/test";
if (!fs::exists(p)) {
    // 路径不存在
} else if (fs::is_regular_file(p)) {
    // 是文件
} else if (fs::is_directory(p)) {
    // 是目录
} else {
    // 可能是符号链接、套接字、FIFO 等其他类型
}</filesystem>

Windows 下用 GetFileAttributes() 需注意 FILE_ATTRIBUTE_DIRECTORY

如果项目不能用 C++17,或需精确控制符号链接行为(比如想区分“链接本身”和“链接目标”),Windows 原生 API 仍常用。但别只看返回值是否为 -1 —— 大部分错误(如权限不足、路径过长)也会返回 -1,需用 GetLastError() 进一步判断。

C++14
C++14

C++14 对 C++11 的修正与增强版本,适合旧系统维护和较老工具链兼容。

下载
  • GetFileAttributes(L"some_path") & FILE_ATTRIBUTE_DIRECTORY 为真,表示是目录(含符号链接指向的目录)
  • 若想跳过符号链接,得先用 GetFileAttributesEx() 配合 GET_FILEEX_INFO_LEVELS::GetFileExInfoStandard,再检查 dwFileAttributes 字段
  • 返回 INVALID_FILE_ATTRIBUTES 不等于“不是目录”,可能是路径不存在、无访问权、或是重解析点(如挂载点)未被识别

Linux/macOS 下用 stat() 看 st_mode 位标志

stat() 是 POSIX 标准方式,比 access() 更可靠,因为它不触发权限检查副作用,且能一次获取全部元数据。

  • 成功时检查 sb.st_mode & S_IFMT 的值:S_IFREG 是普通文件,S_IFDIR 是目录
  • 别直接用 S_ISREG(sb.st_mode) 或 S_ISDIR(sb.st_mode) 宏——它们内部已做掩码,更安全
  • 若 stat() 返回 -1,errno 是关键:ENOENT 是不存在,EACCES 是没权限读取父目录(注意:即使目标存在,也可能因父目录不可执行而失败)
  • 对符号链接,默认 stat() 获取的是目标属性;要用 lstat() 获取链接自身属性

容易忽略的边界情况:符号链接、挂载点、权限与空路径

很多 bug 出在假设“非文件即目录”。实际还有不少中间态:

  • 符号链接可能指向不存在的路径,此时 is_regular_file() 和 is_directory() 都返回 false,但 is_symlink() 为 true
  • 某些文件系统挂载点(如 NFS、/proc)下,stat() 可能成功但 st_mode 不符合常规分类,std::filesystem 在这些场景下行为取决于底层实现
  • 传入空字符串或只含空白符的 fs::path,构造时不会报错,但后续操作会抛异常 —— 建议提前用 p.empty() 或 p.generic_string().find_first_not_of(" \t\n\r") == std::string::npos 过滤
  • 权限问题在容器或沙盒环境里尤其隐蔽:路径存在,但父目录不可遍历(noexec 或 nodev 挂载选项),导致 stat() 或 is_* 失败

真正健壮的判断逻辑,永远要先处理“不存在”和“不可访问”,再分类型,最后考虑“其他类型”的 fallback 分支。

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

相关专题

更多
c++和c语言的区别有哪些
c++和c语言的区别有哪些

c++和c语言的区别:1、面向对象编程(OOP)支持不同;2、新增特性不同;3、标准库不同;4、编译方式不同;5、命名空间不同等等。想了解更多c++的相关内容,可以阅读本专题下面的文章。

2024.03.14

2248

9

c++和python学习顺序推荐
c++和python学习顺序推荐

一般建议先学习C++,再学习Python,因为这样可以逐步从较为底层的编程语言向更高级的语言过渡。想了解更多python的相关内容,可以阅读本专题下面的文章。

2024.03.14

1019

6

python和c++学习性价比分析
python和c++学习性价比分析

Python易于学习,广泛应用于Web开发、数据科学和人工智能等领域,但性能较低。C语言性能高,适用于对性能要求较高的场景,如游戏开发和系统编程,但学习曲线陡峭,错误处理复杂。想了解更多python的相关内容,可以阅读本专题下面的文章。

2024.03.14

447

5

c语言和c++一样吗
c语言和c++一样吗

c语言和c++是两种不同的编程语言,虽然有相似之处,但存在显著差异。c语言专注于过程式编程和系统级开发,以简洁、高效著称。c++作为c语言的超集,引入了面向对象编程,增强了代码组织和管理能力,但学习曲线也更陡峭。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.14

327

5

c语言和c++先学哪个好
c语言和c++先学哪个好

初学者选择学习c语言还是c++语言,需要根据个人学习目标、背景以及编程兴趣和预期应用方向来决定。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.14

426

5

c语言和c++的区别和联系
c语言和c++的区别和联系

c语言和c++是计算机科学领域应用广泛的编程语言。虽然它们有着相似的基础,但它们在语言类型、语法功能和内存管理方面存在着显著差异。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.14

580

5

c++软件中文更改教程
c++软件中文更改教程

对于 ide,可通过打开设置,找到语言设置,选择中文,并保存更改。对于非 ide 应用程序,可查找设置或选项,选择语言设置,更改为中文,并保存更改。想了解更多c++的相关内容,可以阅读本专题下面的文章。

2024.03.21

1409

9

python和java和c++学习性价比分析
python和java和c++学习性价比分析

Python以其易学性、丰富的库和活跃的社区而著称,适合数据科学、人工智能和Web开发。Java以其跨平台性、企业级应用开发和Android应用开发而闻名。C++以其底层控制能力、高效性能和游戏开发而著称。选择哪种语言取决于个人兴趣、职业方向和特定需求。想了解更多python和java和c++的相关内容,可以阅读本专题下面的文章。

2024.03.22

1217

7

c++和c语言学习顺序推荐
c++和c语言学习顺序推荐

对于初学者,建议先学习C语言,掌握编程基础后再转入C++,便于理解面向对象编程概念。有编程经验者可直接学习C++,快速接触高级编程技术。想了解更多c++和c语言的相关内容,可以阅读本专题下面的文章。

2024.03.25

1325

9

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习