
在 C++ 中获取文件大小,最可靠、跨平台的方式是用 std::filesystem::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_size是off_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(),但这在二进制文件中极易出错:
立即学习“C++免费学习笔记(深入)”;
- 若文件以文本模式打开(默认),换行符会被转换(如
\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 对软链接返回目标大小,而 stat 的 st_blocks * 512 才是磁盘占用。别把这两者混为一谈。











