C++怎么删除文件 C++ remove函数与filesystem库删除操作

在C++开发中，删除本地文件是经常会遇到的需求，开发者可以选择传统的C标准库remove函数，也可以使用C++17之后引入的filesystem标准库来完成操作，两种方式各有适用场景。

使用remove函数删除文件

remove函数是C标准库提供的文件删除接口，在C++中也可以直接调用，它的声明位于<cstdio>头文件中，使用方式比较简单。

函数基本说明

remove函数的原型为：

int remove(const char* filename);

参数filename是要删除的文件路径，可以是相对路径也可以是绝对路径。函数返回值为0表示删除成功，返回非0值表示删除失败。

使用示例

下面是使用remove函数删除单个文件的示例代码：

#include <cstdio>
#include <iostream>

int main() {
    const char* filePath = "test.txt";
    // 调用remove函数删除文件
    int result = remove(filePath);
    if (result == 0) {
        std::cout << "文件删除成功" << std::endl;
    } else {
        std::cout << "文件删除失败" << std::endl;
    }
    return 0;
}

注意事项

• remove函数只能删除存在的普通文件，如果路径指向的是目录，删除操作会失败
• 如果文件正在被其他进程占用，删除操作也会返回失败
• 该函数没有异常抛出机制，只能通过返回值判断操作结果

使用filesystem库删除文件

C++17标准引入了<filesystem>头文件，提供了更完善的文件系统操作接口，删除文件可以使用std::filesystem::remove函数。

函数基本说明

filesystem库的remove函数有两个重载版本：

// 删除指定路径的文件或空目录，返回是否删除成功
bool remove(const path& p);
// 删除指定路径的文件或空目录，通过ec参数返回错误信息，不抛出异常
bool remove(const path& p, error_code& ec) noexcept;

其中path是filesystem库定义的路径类型，支持字符串隐式转换，error_code用于接收操作错误信息。

使用示例

下面是使用filesystem库删除文件的示例代码：

#include <filesystem>
#include <iostream>

namespace fs = std::filesystem;

int main() {
    fs::path filePath = "test.txt";
    // 方式1：直接调用，失败会抛出异常
    try {
        bool success = fs::remove(filePath);
        if (success) {
            std::cout << "文件删除成功" << std::endl;
        } else {
            std::cout << "文件不存在，无需删除" << std::endl;
        }
    } catch (const fs::filesystem_error& e) {
        std::cout << "删除失败，错误信息：" << e.what() << std::endl;
    }

    // 方式2：使用error_code接收错误，不抛出异常
    std::error_code ec;
    bool success = fs::remove(filePath, ec);
    if (ec) {
        std::cout << "删除失败，错误信息：" << ec.message() << std::endl;
    } else if (success) {
        std::cout << "文件删除成功" << std::endl;
    } else {
        std::cout << "文件不存在，无需删除" << std::endl;
    }
    return 0;
}

扩展操作

如果需要删除非空目录，可以使用std::filesystem::remove_all函数，它会递归删除目录下的所有文件和子目录，使用方式和remove函数类似。

两种方式对比

两种删除文件的方式对比如下：

操作注意事项

• 删除文件前建议先判断文件是否存在，避免不必要的错误判断
• 操作文件时需要确保程序对目标文件有对应的写权限，否则会删除失败
• 如果删除的是软链接，默认删除的是软链接本身，不会删除软链接指向的原文件
• 使用filesystem库时，如果编译器版本较低，可能需要添加对应的编译选项，比如GCC需要添加-std=c++17或者-std=c++2a参数

C++remove函数filesystem库文件删除修改时间：2026-07-03 18:51:36