std::filesystem::file_size可直接获取文件字节数,传入path对象,返回uintmax_t类型值;若文件不存在、无权限或非普通文件,则抛出filesystem_error异常。

在 C++17 中,std::filesystem 提供了简洁、跨平台的方式获取文件大小,无需依赖系统 API 或手动打开文件读取元数据。
使用 std::filesystem::file_size 获取文件大小
这是最直接的方法,传入一个 std::filesystem::path 对象,返回 std::uintmax_t 类型的字节数。如果文件不存在、无权限或不是普通文件,会抛出 std::filesystem::filesystem_error 异常。
示例:
#include#include int main() { try { auto size = std::filesystem::file_size("data.txt"); std::cout << "File size: " << size << " bytes\n"; } catch (const std::filesystem::filesystem_error& e) { std::cerr << "Error: " << e.what() << '\n'; } }
安全检查:先确认文件存在且是常规文件
避免异常的常见做法是提前验证路径有效性。注意:is_regular_file() 会隐式检查存在性,但单独调用 exists() 并不能保证后续 file_size() 成功(可能被并发删除或权限变更)。
立即学习“C++免费学习笔记(深入)”;
- 推荐组合判断:
exists(p) && is_regular_file(p) - 若只需“尽力获取”,仍建议用 try-catch,更健壮
- 符号链接默认被解引用;如需获取链接文件本身大小(而非目标),用
file_size(p, std::filesystem::symlink_option::no_follow)
处理目录或特殊文件类型
std::filesystem::file_size 仅对常规文件(regular file)定义有效。对目录、套接字、FIFO、设备文件等调用会抛异常。
可借助类型判断做分支处理:
-
is_directory(p)→ 可递归统计(需自行遍历) -
is_symlink(p)→ 按需决定是否跟随 -
is_block_file(p) || is_character_file(p)→ 通常不适用file_size
性能与注意事项
该函数底层调用操作系统 stat 系统调用,开销极小,不读取文件内容,纯元数据操作。
- 确保编译器支持 C++17 并启用
-std=c++17(GCC/Clang)或/std:c++17(MSVC) - 链接时可能需要显式链接
stdc++fs(旧版 GCC,如 8.x);GCC 9+ 和 Clang 通常自动处理 - Windows 下支持 NTFS、ReFS;Linux/macOS 支持主流文件系统











