c++中如何获取文件大小_c++获取指定文件字节数的方法【汇总】

最可靠跨平台方式是用C++17的std::filesystem::file_size,返回字节总数,需处理filesystem_error异常,GCC/Clang需链接-lstdc++fs。

在 C++ 中获取文件大小,最可靠、跨平台的方式是用 std::f

ilesystem::file_size(C++17 起)。它直接返回 std::uintmax_t 类型的字节数,无需手动打开/读取/定位,也避开了旧方法中常见的符号扩展、精度丢失或平台差异问题。

std::filesystem::file_size 获取大小(推荐)

这是目前最简洁、安全、标准的做法。前提是编译器支持 C++17 且启用了 std::filesystem(GCC/Clang 需链接 -lstdc++fs,MSVC 默认支持)。

  • 路径支持 std::filesystem::path 或 C 字符串(如 "data.bin"
  • 若文件不存在、无权限或路径为目录,会抛出 std::filesystem::filesystem_error 异常
  • 返回值是字节总数,对普通文件即文件大小;对符号链接默认解析目标(可选不解析)
try {
    std::uintmax_t size = std::filesystem::file_size("config.json");
    std::cout << "Size: " << size << " bytes\n";
} catch (const std::filesystem::filesystem_error& e) {
    std::cerr << "Error: " << e.what() << '\n';
}

fstat / _stat64(Windows 兼容旧代码)

当项目仍需支持 C++11 或无法使用 std::filesystem 时,底层系统调用仍是可行选择。但要注意:Linux/macOS 用 fstat(需先 open),Windows 用 _stat64(直接传路径),两者结构体字段名和类型略有不同。

  • fstat 返回的 st_sizeoff_t,在某些 32 位系统上可能截断大于 2GB 的文件
  • Windows 上必须用 _stat64(而非 _stat)才能正确处理大文件
  • 需要手动包含头文件:(POSIX)或 + (Windows)
// Linux/macOS 示例
#include 
#include 
#include 

int fd = open("log.txt", O_RDONLY); if (fd != -1) { struct stat sb; if (fstat(fd, &sb) == 0) { off_t size = sb.st_size; // 注意:不是所有平台都保证 st_size 为 uint64_t } close(fd); }

避免用 seekg + tellg 操作流(常见坑)

很多教程教用 std::ifstream 打开文件后 seekg(0, std::ios::end)tellg(),但这在二进制文件中极易出错:

  • 若文件以文本模式打开(默认),换行符会被转换(如 \r\n\n),tellg() 返回的是“逻辑位置”,非真实字节数
  • 某些标准库实现(尤其老版本 libstdc++)对大文件返回 -1 或负值(std::streampos 有符号)
  • 未检查 failbit:如果 seekg 失败(如只读文件被以写入方式打开),tellg 会返回 -1 且不报错
// ❌ 不推荐(尤其对二进制文件)
std::ifstream f("image.png"); // 默认 text mode!
f.seekg(0, std::ios::end);
std::streampos size = f.tellg(); // 可能为 -1,也可能不准
f.close();

注意 Windows 下 Unicode 路径和长路径

如果文件路径含中文或超过 MAX_PATH(260 字符),std::filesystem::file_size 在 Windows 上默认能处理(内部调用宽字符 API),但传统 C 接口如 _stat64 会失败。

  • 确保编译时定义 UNICODE_UNICODE(MSVC)
  • 避免硬编码 ANSI 路径字符串;优先用 std::filesystem::path 构造路径
  • 若必须用旧接口,改用 _wstat64 并传 const wchar_t*

真正麻烦的不是“怎么写”,而是“什么时候该信哪个值”——比如 file_size 对软链接返回目标大小,而 statst_blocks * 512 才是磁盘占用。别把这两者混为一谈。