std::filesystem::file_size 是 C++17 起获取文件大小最直接推荐的方式,需包含头文件、启用命名空间,抛出 filesystem_error 异常,建议用 try/catch 捕获。

用 std::filesystem::file_size 最直接(C++17 起)
这是目前最推荐的方式,语义清晰、跨平台、无需手动打开文件。前提是编译器支持 C++17 且启用了 std::filesystem(部分旧环境需链接 -lstdc++fs)。
- 必须包含头文件:
#include - 命名空间为
std::filesystem,常用写法:using namespace std::filesystem; - 抛出
filesystem_error异常(如路径不存在、无权限),建议用try/catch包裹
try {
uint64_t size = file_size("data.bin");
std::cout << "Size: " << size << " bytes\n";
} catch (const filesystem_error& e) {
std::cerr << "Cannot get size: " << e.what() << '\n';
}用 fseek + ftell(C 风格,兼容性最强)
适用于所有 C++ 标准版本,但只对普通文件可靠;对设备文件、管道、某些网络文件系统可能返回错误或 -1。
- 必须以二进制模式打开(
"rb"),否则 Windows 下文本模式会干扰换行符计数 -
fseek(fp, 0, SEEK_END)移动到末尾,ftell(fp)返回当前位置(即字节数) - 调用后记得
fclose(fp),且要检查fopen和ftell的返回值
FILE* fp = fopen("data.bin", "rb");
if (!fp) {
perror("fopen");
return -1;
}
if (fseek(fp, 0, SEEK_END) != 0) {
perror("fseek");
fclose(fp);
return -1;
}
long size = ftell(fp);
fclose(fp);
if (size == -1) {
perror("ftell");
return -1;
}用 stat 系统调用(Unix/Linux/macOS)
不依赖 C++ 标准库版本,效率高,但非 Windows 原生支持(MSVC 提供 _stat64 替代,需条件编译)。
- 头文件:
#include(Unix)或#include+#include(Windows) - 结构体字段是
st_size,类型为off_t(可能为 64 位) - 注意:
stat对符号链接默认解析目标,若需链接自身大小,用lstat
struct stat sb;
if (stat("data.bin", &sb) == 0) {
std::cout << "Size: " << sb.st_size << " bytes\n";
} else {
perror("stat");
}为什么不用 ifstream::tellg 直接读取长度?
常见误区:打开 std::ifstream 后直接调用 seekg(0, std::ios::end); tellg()。它在多数情况下能工作,但有隐含风险:
立即学习“C++免费学习笔记(深入)”;
- 流必须以
std::ios::binary模式打开,否则文本模式下seekg行为未定义(尤其 Windows) - 某些标准库实现对空文件或特殊文件系统返回 -1
- 流状态标志(如
failbit)可能被意外置位,需手动clear() - 相比
file_size或stat,它多了一次文件打开/关闭开销,且语义上不是“获取元数据”,而是“模拟 seek”
真正需要流对象时再这么做;仅查大小,优先选更轻量、更语义明确的接口。
实际项目中,如果已用 C++17 且不需支持极老工具链,std::filesystem::file_size 是最省心的选择;否则按平台选 stat 或 fseek,并务必检查错误返回值——很多 bug 就出在忽略 file_size 抛异常、ftell 返回 -1、stat 返回 -1 这些地方。











