std::filesystem::file_size 是 c++17 起获取文件大小最直接、标准、跨平台的方法,需确保路径存在且为普通文件,返回类型为 std::uintmax_t,对目录会抛出 filesystem_error。

用 std::filesystem::file_size 最直接(C++17 起)
这是标准、跨平台、语义清晰的做法,只要编译器支持 C++17 且启用了 std::filesystem(部分旧版 GCC 需链接 -lstdc++fs)。
常见错误是传入非法路径或目录——file_size 对目录抛出 std::filesystem::filesystem_error,不是返回 0 或 -1。
- 确保路径存在且是普通文件:
std::filesystem::is_regular_file(path)先检查 - 路径可为
std::string、const char*或std::filesystem::path - 返回类型是
std::uintmax_t,不是int或size_t(大文件可能超 4GB)
try {
auto size = std::filesystem::file_size("data.bin");
std::cout <h3>用 <code>fstat</code> / <code>stat</code>(POSIX 系统,兼容性高)</h3><p>在 Linux/macOS 或 MinGW 下可靠,不依赖 C++17,但需包含 <code><sys></sys></code>,且路径必须是本地文件系统路径(不支持某些虚拟路径或 UNC 的 Windows 原生行为)。</p><p>容易踩的坑:忘记检查 <code>stat()</code> 返回值,直接读 <code>st_size</code>;或误用 <code>struct stat64</code> 而没配对使用 <code>stat64()</code>(64 位文件大小在旧系统上需显式启用宏)。</p>
- Linux/macOS 推荐用
struct stat+stat(),默认支持大文件(glibc 2.2+) - 需要严格 POSIX 兼容时,定义
_FILE_OFFSET_BITS=64编译 - Windows 上 MinGW 支持,但 MSVC 默认不提供
stat,需用_stat64和_S_IFREG
struct stat sb;
if (stat("log.txt", &sb) == 0 && S_ISREG(sb.st_mode)) {
off_t size = sb.st_size; // 注意:off_t 在不同平台有符号/位宽差异
}
用 fseek+ftell(老派但通用,有陷阱)
适用于已打开的 FILE*,无需路径字符串,但仅限可寻址流(不能用于管道、终端、某些设备文件),且会改变文件指针位置。
最常被忽略的问题:二进制模式下 ftell 对文本文件行为未定义;Windows 文本模式换行符转换会导致 ftell 返回值 ≠ 实际字节数。
- 务必用
"rb"模式打开文件 - 调用前保存原位置(
fseek(fp, 0, SEEK_CUR)),结束后恢复(否则后续读写错位) - 32 位程序中
long类型的ftell返回值无法表示 >2GB 文件
FILE* fp = fopen("image.jpg", "rb");
if (fp) {
fseek(fp, 0, SEEK_END);
long size = ftell(fp); // 注意:long 可能不够大
fseek(fp, 0, SEEK_SET); // 恢复位置
fclose(fp);
}
Windows API:GetFileSizeEx(仅 Windows,精度高)
比 GetFileSize 更安全,直接返回 LARGE_INTEGER,避免高低位拆分和溢出判断,适合超大文件(如视频、虚拟磁盘镜像)。
典型错误:传入无效句柄、忽略 GetLastError()、或对非文件句柄(如控制台)调用导致未定义行为。
- 句柄必须由
CreateFile以GENERIC_READ打开,且不能是INVALID_HANDLE_VALUE - 需检查返回值是否为 0,并用
GetLastError()区分是失败还是文件大小真为 0 - 不支持符号链接重解析(除非创建时带
FILE_FLAG_OPEN_REPARSE_POINT)
HANDLE h = CreateFile(L"dump.bin", GENERIC_READ, FILE_SHARE_READ,
nullptr, OPEN_EXISTING, 0, nullptr);
if (h != INVALID_HANDLE_VALUE) {
LARGE_INTEGER size;
if (GetFileSizeEx(h, &size)) {
std::cout <p>真正麻烦的不是选哪个函数,而是统一处理路径有效性、权限不足、符号链接循环、挂载点断开这些边界情况。哪怕只用 <code>file_size</code>,也得包一层异常捕获并映射成你自己的错误码——标准库不会替你决定“文件不存在”该报错还是静默返回默认值。</p>C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











