std::filesystem::create_directory仅创建最后一级目录,父目录不存在时失败;应使用create_directories递归创建。remove_all可删除非空目录,返回删除项数,无回收站且不可逆。

用 std::filesystem::create_directory 创建文件夹
C++17 起,标准库正式支持文件系统操作,std::filesystem 是最可靠、跨平台的方案。它能处理路径分隔符(自动适配 / 或 \),也支持相对/绝对路径。
- 必须包含头文件:
#include <filesystem></filesystem>,并链接-lstdc++fs(GCC 早期版本需显式链接,Clang 和 GCC 10+ 通常默认启用) -
create_directory只创建最后一级目录;若父目录不存在,会失败并抛出std::filesystem::filesystem_error - 若目录已存在,函数返回
false,不报错(这是设计行为,不是错误)
#include <filesystem>
namespace fs = std::filesystem;
<p>try {
bool ok = fs::create_directory("build/obj"); // 失败:build 不存在
fs::create_directories("build/obj"); // ✅ 正确:递归创建所有必要父目录
} catch (const fs::filesystem_error& e) {
// e.what() 包含具体错误,如 "No such file or directory"
}</p></filesystem>
用 std::filesystem::remove_all 删除整个文件夹
删除非空目录必须用 remove_all,它递归删除目录及其所有内容(文件、子目录、符号链接目标等)。注意:
-
remove只删空目录或单个文件;对非空目录会失败 -
remove_all返回被删除的项数(类型为std::uintmax_t),若路径不存在则返回 0 - 没有“回收站”或确认机制,删除不可逆;权限不足或文件被占用时会抛异常
try {
auto n = fs::remove_all("build"); // 删除 build 及其全部内容
if (n == 0) {
// "build" 不存在,或不是目录(比如是普通文件)
}
} catch (const fs::filesystem_error& e) {
// 常见错误:Permission denied(Windows 下文件正被打开)、Access is denied
}
Windows 下用 CreateDirectoryA / RemoveDirectoryA 的坑
虽然 Win32 API 可用,但和 std::filesystem 相比,缺点明显:
- 路径分隔符必须用
\(单反斜杠在字符串中要写成"C:\temp") -
CreateDirectoryA不支持递归创建,且返回值是 BOOL,需配合GetLastError()判断失败原因(比如ERROR_PATH_NOT_FOUND) -
RemoveDirectoryA要求目录为空,否则失败;清空需手动遍历 +DeleteFileA+ 递归调用,极易出错 - Unicode 支持麻烦(得用
CreateDirectoryW+std::wstring),而std::filesystem自动处理编码
除非你明确受限于 C++14 或更低标准,否则没必要绕过标准库去调 Win32。
常见错误和权限问题
- 在 Windows 上,目标目录被 IDE、资源管理器、杀毒软件或自己进程中的
std::fstream 打开时,remove_all 会失败并抛出 access_denied
- Linux/macOS 下注意当前用户是否对父目录有
w 权限(否则无法创建子项);chmod -w parent/ 后 create_directories 就会失败
- 路径含中文或特殊字符时,确保源文件以 UTF-8 保存(MSVC 默认 ANSI,需加
#pragma execution_character_set("utf-8") 或改用宽字符接口)
std::fstream 打开时,remove_all 会失败并抛出 access_denied
w 权限(否则无法创建子项);chmod -w parent/ 后 create_directories 就会失败#pragma execution_character_set("utf-8") 或改用宽字符接口)真正容易被忽略的是:跨平台代码里混用 "/" 和 "\" 字面量,或者假设 create_directory 会自动建父目录——这会让程序在 CI 环境或不同开发机上表现不一致。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











