c++中如何获取文件的字节大小_c++获取文件长度的方法

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),且要检查 fopenftell 的返回值
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()。它在多数情况下能工作,但有隐含风险:

  • 流必须以 std::ios::binary 模式打开,否则文本模式下 seekg 行为未定义(尤其 Windows)
  • 某些标准库实现对空文件或特殊文件系统返回 -1
  • 流状态标志(如 failbit)可能被意外置位,需手动 clear()
  • 相比 file_sizestat,它多了一次文件打开/关闭开销,且语义上不是“获取元数据”,而是“模拟 seek”

真正需要流对象时再这么做;仅查大小,优先选更轻量、更语义明确的接口。

实际项目中,如果已用 C++17 且不需支持极老工具链,std::filesystem::file_size 是最省心的选择;否则按平台选 statfseek,并务必检查错误返回值——很多 bug 就出在忽略 file_size 抛异常、ftell 返回 -1、stat 返回 -1 这些地方。