应优先使用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
<h3>Windows 下用 <code>GetFileSizeEx</code> 避免 32 位截断</h3>
<p>如果项目必须兼容 C++14 或不能用 <code><filesystem></filesystem></code>,Windows 平台推荐 <code>GetFileSizeEx</code>,它通过 <code>LARGE_INTEGER</code> 返回 64 位大小,不会像老式 <code>GetFileSize</code> 那样在 >4GB 时返回错误值(高位丢失)。</p>
<p>容易踩的坑是:打开文件时没指定 <code>GENERIC_READ</code> 权限,或没用 <code>FILE_SHARE_READ</code> 导致其他进程访问失败;还有忘记关闭句柄造成资源泄漏。</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill5502" title="C++ Code Review Master"><img
src="https://img.php.cn/upload/skill/000/000/081/179051228971575.jpg" alt="C++ Code Review Master" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/skill5502" title="C++ Code Review Master" class="overflowclass">C++ Code Review Master</a>
<p class="overflowclass">组合式C++代码评审方案,融合静态分析、AI推理、多轮迭代评审和C++专项检查,适用于PR审查、增量代码审查、全项目评审和代码质量评分,触发词包括review cpp、cpp代码评审、C++review、代码审查。</p>
</div>
<a rel="nofollow" href="/xiazai/skill5502" title="C++ Code Review Master" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
<ul>
<li>使用 <code>CreateFileW</code> 打开文件,避免 ANSI 路径编码问题</li>
<li>必须检查返回句柄是否为 <code>INVALID_HANDLE_VALUE</code>
</li>
<li>
<code>GetFileSizeEx</code> 成功时返回非零值,失败时返回 0 且需调用 <code>GetLastError()</code>
</li>
</ul>
<h3>POSIX 系统用 <code>stat</code> 或 <code>fstat</code> 更轻量</h3>
<p>Linux/macOS 下,<code>stat</code> 是最常用方案,它不依赖 C++ 标准库版本,且性能开销极小。注意 <code>st_size</code> 字段类型是 <code>off_t</code>,在某些旧系统上可能是 32 位,但现代 glibc 默认启用 <code>_FILE_OFFSET_BITS=64</code>,实际可用。</p>
<p>用 <code>fstat</code> 替代 <code>stat</code> 可省去重复打开文件的开销(当你已有文件描述符时),但要注意 fd 生命周期管理。</p>
<ul>
<li>
<code>stat</code> 的路径参数不能是空字符串或 <code>nullptr</code>,否则行为未定义</li>
<li>检查 <code>stat()</code> 返回值是否为 0,非零表示失败(如文件不存在、无权限)</li>
<li>不要直接打印 <code>st.st_size</code> 作为 <code>int</code>,应使用 <code>%jd</code> 格式化或转成 <code>static_cast<long long></long></code>
</li>
</ul>
<pre class="brush:php;toolbar:false;">#include <sys>
#include <cstdio>
struct stat st;
if (stat("input.txt", &st) == 0) {
printf("%lld bytes\n", static_cast<long long>(st.st_size));
}</long></cstdio></sys>
为什么不用 seekg + tellg?
有人尝试用 std::ifstream 的 seekg(0, std::ios::end) 再 tellg() 获取大小,但这不是可靠方法:
- 文本模式下,换行符转换可能导致
tellg()返回值不等于实际字节数 - 某些流实现(尤其是 Windows 上的 CRT)对二进制文件末尾定位不准
- 如果文件被其他进程锁定或只读,
open()可能失败,而stat或file_size仍可读取元数据 - 无法区分“文件为空”和“打开失败”,错误处理模糊
除非你明确控制文件打开方式(std::ios::binary)、且不关心跨平台一致性,否则别用它替代系统级接口。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!










