std::filesystem::file_size 是 C++17 起最直接、不打开文件即可获取大小的标准方案,底层调用 stat 或 GetFileSizeEx,需确保编译器支持 C++17、链接 stdc++fs(GCC/Clang)、路径有效且非符号链接解引用。

std::filesystem::file_size 是最直接的方案
不打开文件就能获取大小,std::filesystem::file_size 是 C++17 起标准库提供的正确方式。它底层调用系统 API(如 stat 系统调用),不读取文件内容,开销极小。
使用前需确保:
- 编译器支持 C++17 或更高(GCC 8+、Clang 7+、MSVC 2017 15.7+)
- 链接
stdc++fs(GCC/Clang 下需显式加-lstdc++fs;MSVC 无需) - 路径为有效且可访问的文件(非目录、非符号链接未解引用——除非你明确想查链接本身大小)
示例:
#include <filesystem>
#include <iostream>
int main() {
try {
auto size = std::filesystem::file_size("data.bin");
std::cout << size << " bytes\n";
} catch (const std::filesystem::filesystem_error& e) {
std::cerr << e.what() << '\n'; // 比如 "No such file or directory"
}
}
Windows 上用 GetFileSizeEx 避免 4GB 限制
std::filesystem::file_size 返回 std::uintmax_t,理论上能表示超大文件,但某些旧版 MSVC 的 std::filesystem 实现曾对 >4GB 文件返回错误值(已修复)。若需兼容较老环境或追求绝对可控,可直接调 Windows API:
立即学习“C++免费学习笔记(深入)”;
-
GetFileSizeEx返回LARGE_INTEGER,原生支持 >4GB - 必须先用
CreateFile打开句柄(只读 +FILE_ATTRIBUTE_NORMAL),但**不调用ReadFile**,所以仍算“不打开文件内容” - 记得用
CloseHandle释放句柄,否则泄漏
关键代码片段:
HANDLE h = CreateFile(L"input.dat", GENERIC_READ, FILE_SHARE_READ,
nullptr, OPEN_EXISTING, FILE_ATTRIBUTE_NORMAL, nullptr);
if (h != INVALID_HANDLE_VALUE) {
LARGE_INTEGER size;
if (GetFileSizeEx(h, &size)) {
std::cout << size.QuadPart << " bytes\n";
}
CloseHandle(h);
}
Linux/macOS 用 stat 系统调用更轻量
如果项目不依赖 C++17,或需要极致精简(比如嵌入式场景),直接调 stat 更底层、无额外依赖:
-
stat填充struct stat,其中st_size字段即文件字节数 - 注意:传入路径必须是真实文件路径,符号链接需用
lstat查链接自身元数据,stat会自动解引用 - POSIX 兼容,所有 Unix-like 系统都可用
示例:
#include <sys/stat.h>
#include <unistd.h>
struct stat sb;
if (stat("log.txt", &sb) == 0) {
std::cout << sb.st_size << " bytes\n";
} else {
perror("stat"); // 输出类似 "No such file or directory"
}
容易踩的坑:路径、权限和符号链接
三种方法都会失败,但原因常被忽略:
- 相对路径基于当前工作目录(
getcwd),不是源文件所在目录——想查当前源码同级文件,得先拼出完整路径 - 没有读权限时,
stat和GetFileSizeEx通常仍能读取大小(只要执行权限 + 目录可遍历);但std::filesystem::file_size在某些平台可能抛异常 - 符号链接默认被解引用,若要查链接文件本身的大小(即 link text 长度),Linux/macOS 用
lstat,Windows 则需GetFileAttributesEx配合FILE_ATTRIBUTE_REPARSE_POINT判断后特殊处理
跨平台项目里,别假设 std::filesystem::file_size("config.json") 一定成功——先 std::filesystem::exists 再查,比捕获异常更主动。


















