应优先使用C++17的std::filesystem::file_size,它跨平台、不打开文件、返回uintmax_t防溢出,但需先用is_regular_file判断并捕获filesystem_error异常。

用 std::filesystem::file_size 最直接可靠
C++17 起,std::filesystem::file_size 是获取文件大小的首选方式,它返回 std::uintmax_t 类型的字节数,能正确处理大文件(如 >2GB),且自动处理符号链接、权限等边界情况。
常见错误是传入无效路径或目录——它只接受普通文件,对目录会抛出 std::filesystem::filesystem_error 异常。
- 确保已启用 C++17 或更高标准(编译时加
-std=c++17) - 链接
-lstdc++fs(GCC 早期版本需显式链接,Clang 和 GCC 10+ 通常自动处理) - 检查路径是否存在且为常规文件:
std::filesystem::is_regular_file(path) - 捕获异常比忽略更安全,尤其在生产环境中
#include <filesystem>
#include <iostream>
namespace fs = std::filesystem;
int main() {
try {
auto size = fs::file_size("data.bin");
std::cout << size << " bytes\n";
} catch (const fs::filesystem_error& e) {
std::cerr << "Error: " << e.what() << "\n";
}
}
Windows 下用 GetFileSizeEx 避免 32 位截断
如果项目必须兼容 C++14 或不能用 <filesystem>,Windows 平台推荐 GetFileSizeEx,它通过 LARGE_INTEGER 返回 64 位大小,不会像老式 GetFileSize 那样在 >4GB 时返回错误值(高位丢失)。
容易踩的坑是:打开文件时没指定 GENERIC_READ 权限,或没用 FILE_SHARE_READ 导致其他进程访问失败;还有忘记关闭句柄造成资源泄漏。
立即学习“C++免费学习笔记(深入)”;
组合式C++代码评审方案,融合静态分析、AI推理、多轮迭代评审和C++专项检查,适用于PR审查、增量代码审查、全项目评审和代码质量评分,触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 使用
CreateFileW打开文件,避免 ANSI 路径编码问题 - 必须检查返回句柄是否为
INVALID_HANDLE_VALUE -
GetFileSizeEx成功时返回非零值,失败时返回 0 且需调用GetLastError()
POSIX 系统用 stat 或 fstat 更轻量
Linux/macOS 下,stat 是最常用方案,它不依赖 C++ 标准库版本,且性能开销极小。注意 st_size 字段类型是 off_t,在某些旧系统上可能是 32 位,但现代 glibc 默认启用 _FILE_OFFSET_BITS=64,实际可用。
用 fstat 替代 stat 可省去重复打开文件的开销(当你已有文件描述符时),但要注意 fd 生命周期管理。
-
stat的路径参数不能是空字符串或nullptr,否则行为未定义 - 检查
stat()返回值是否为 0,非零表示失败(如文件不存在、无权限) - 不要直接打印
st.st_size作为int,应使用%jd格式化或转成static_cast<long long>
#include <sys/stat.h>
#include <cstdio>
struct stat st;
if (stat("input.txt", &st) == 0) {
printf("%lld bytes\n", static_cast<long long>(st.st_size));
}
为什么不用 seekg + tellg?
有人尝试用 std::ifstream 的 seekg(0, std::ios::end) 再 tellg() 获取大小,但这不是可靠方法:
- 文本模式下,换行符转换可能导致
tellg()返回值不等于实际字节数 - 某些流实现(尤其是 Windows 上的 CRT)对二进制文件末尾定位不准
- 如果文件被其他进程锁定或只读,
open()可能失败,而stat或file_size仍可读取元数据 - 无法区分“文件为空”和“打开失败”,错误处理模糊
除非你明确控制文件打开方式(std::ios::binary)、且不关心跨平台一致性,否则别用它替代系统级接口。

















