c++如何判断文件是否存在 c++文件系统库filesystem【教程】

在C++17中,判断文件是否存在最直接推荐的方式是使用std::filesystem::exists(),需包含头文件、启用C++17及以上标准,并建议用namespace fs = std::filesystem简化书写。

在 C++17 中,标准库引入了 头文件,提供了跨平台的文件系统操作能力。判断文件是否存在,最直接、推荐的方式就是使用 std::filesystem::exists()

使用 std::filesystem::exists()

这是最常用也最直观的方法。它返回一个 bool,表示路径所指的对象(文件、目录、符号链接等)是否存在且可访问。

  • 需要包含头文件:#include
  • 需启用 C++17 或更高标准(如编译时加 -std=c++17
  • 注意命名空间:通常用 namespace fs = std::filesystem; 简化书写

示例代码:

#include 
#include 

namespace fs = std::filesystem;

int main() {
    std::string path = "test.txt";
    if (fs::exists(path)) {
        std::cout << "文件存在\n";
    } else {
        std::cout << "文件不存在\n";
    }
    return 0;
}

区分文件和目录:用 is_regular_file()is_directory()

exists() 只告诉“存在”,但不说明类型。若你只关心“是不是普通文件”,应进一步判断:

  • fs::is_regular_file(path):确认是普通文件(非目录、非设备、非 socket 等)
  • fs::is_directory(path):确认是目录
  • 二者都隐式调用 exists(),所以无需先单独检查存在性

例如,严格判断“是否存在一个普通文件”:

if (fs::is_regular_file("data.csv")) {
    std::cout << "data.csv 是一个普通文件\n";
}

处理异常与权限问题

exists() 在遇到无权限访问的路径(如某些系统目录)时,可能抛出 std::filesystem::filesystem_error。若程序需健壮运行,建议捕获异常:

try {
    if (fs::exists("restricted/file.txt")) {
        std::cout << "存在\n";
    }
} catch (const fs::filesystem_error& e) {
    std::cerr << "文件系统错误: " << e.what() << '\n';
}

如果不想处理异常,也可用带 std::error_code& 参数的重载版本,它不会抛异常,而是把错误信息写入 error_code 对象。

兼容旧版编译器或备用方案(不推荐)

若无法使用 C++17(如老项目限制),可考虑 POSIX 的 access()(Linux/macOS)或 Windows API 的 GetFileAttributes()。但这些不是跨平台的,且语义不如 filesystem 清晰,容易出错(比如对目录返回“存在”但误当作文件)。除非有强约束,否则不建议回退使用。