std::filesystem::file_size 会抛出 std::filesystem::filesystem_error 异常,必须用 try/catch 捕获或先通过 exists() 和 is_regular_file() 预检;它仅适用于常规文件,对目录、符号链接(默认)、设备文件等无效;Windows 下需注意路径编码与权限问题;频繁调用应缓存结果。

std::filesystem::file_size 会抛异常,必须捕获
直接调用 std::filesystem::file_size 读取不存在的文件、权限不足的路径或符号链接未解引用时,会抛出 std::filesystem::filesystem_error。不处理就 crash。
- 务必用
try/catch包裹,或先用exists()和is_regular_file()预检 - 注意:即使路径存在,也可能是目录、socket 或设备文件,
file_size只对常规文件有效 - Windows 下对某些系统文件(如
C:\pagefile.sys)可能因权限拒绝而失败,即使exists()返回true
获取大小前要确认是 regular_file
std::filesystem::file_size 对目录、符号链接(默认)、管道等类型不适用——它只定义在常规文件上。误传目录路径会触发异常,而非返回 0 或子项总和。
- 正确做法:
std::filesystem::path p = "data.bin"; if (std::filesystem::exists(p) && std::filesystem::is_regular_file(p)) { try { auto size = std::filesystem::file_size(p); // 使用 size... } catch (const std::filesystem::filesystem_error& e) { // 处理读取失败(如权限、I/O 错误) } } - 不要依赖
is_symlink()后手动symlink_status()——file_size默认不解引符号链接;如需目标文件大小,应先用std::filesystem::read_symlink(p)获取目标再调用
跨平台注意 path 参数的编码与格式
在 Windows 上,传入含中文或特殊字符的 std::string 路径(尤其使用 UTF-8 编译时),可能被误解析为本地 ANSI 编码,导致 file_size 找不到文件。
- 推荐统一用
std::filesystem::path构造,它能自动处理宽字符转换(std::wstring在 Windows 下更稳妥) - 避免拼接裸字符串:
"C:\\Users\\" + username + "\\file.txt"→ 改用std::filesystem::path("C:/Users") / username / "file.txt" - Linux/macOS 下路径分隔符用
/即可,std::filesystem::path会自动适配
性能敏感场景慎用 file_size 多次调用
每次调用 std::filesystem::file_size 都是一次系统调用(stat() 或类似),频繁查同一文件大小会带来可观开销。
立即学习“C++免费学习笔记(深入)”;
- 若需多次访问大小,缓存结果比反复调用更高效
- 注意缓存失效:文件可能被外部进程修改,
file_size不提供一致性保证;如需强一致性,配合last_write_time()判断是否变更 - 对临时文件或日志轮转场景,不要假设
file_size结果长期有效
try/catch。











