stat 返回 -1 且 errno = ENOENT 最常见原因是路径不存在或权限不足;需包含对应头文件、注意路径格式与分隔符、校验输入、区分 stat/lstat、处理大文件类型宽度限制、优先用 C++17 std::filesystem::file_size 并检查 st_mode,Windows 下注意文本模式写入影响。

stat 函数返回 -1 且 errno = ENOENT
调用 stat 失败最常见原因是路径不存在或权限不足,但很多人只检查返回值,忽略 errno。Linux/macOS 下必须包含 <sys/stat.h> 和 <errno.h>,Windows 则要用 _stat(需 <sys/stat.h>)且路径分隔符得是反斜杠或双正斜杠。
- 确保传入的是绝对路径,或确认当前工作目录符合预期——
stat("data.txt")在 IDE 里跑可能失败,因为工作目录不是源码所在目录 - 路径含中文或空格时,
stat本身能处理,但若路径来自用户输入,记得先做 trim 和合法性校验,避免尾部换行符导致ENOENT - macOS 对 APFS 卷上的硬链接、符号链接行为和 Linux 略有差异;若要获取目标文件大小,用
stat;若要获取符号链接自身大小,用lstat
st_size 字段在大文件上为 0 或负值
st_size 是 off_t 类型,在 32 位编译环境下可能只有 32 位宽,遇到大于 2GB 的文件就会截断或显示异常。这不是 bug,是类型宽度限制。
- 编译时加
-D_FILE_OFFSET_BITS=64(Linux/macOS)或-D__USE_LARGEFILE64(部分旧系统),让off_t实际为 64 位 - Windows 下用
_stat64替代_stat,对应结构体是struct _stat64,字段名仍是st_size,但类型是__int64 - 不要用
int或long直接接收st.st_size,应声明为off_t size = st.st_size;
stat 和 std::filesystem::file_size 怎么选
C++17 起 std::filesystem::file_size 更安全易用,但它底层仍可能调用 stat(POSIX)或 GetFileSizeEx(Windows),区别在于异常语义和路径处理。
- 如果已用 C++17 且不需支持老旧环境,优先写
std::filesystem::file_size(path):自动处理路径标准化、抛出std::filesystem::filesystem_error,错误信息更明确 - 若需最小依赖或嵌入式场景(无 STL filesystem 支持),坚持用
stat,但务必检查st_mode是否为常规文件——S_ISREG(st.st_mode) == 0时st_size无意义(比如是目录、设备文件) -
stat不触发访问时间更新(atime),而某些file_size实现可能间接引起,对高 I/O 敏感场景要注意
Windows 下 _stat 返回的 st_size 比实际小 1
极少见但真实存在:当文件以文本模式打开并写入(尤其跨平台生成的文件),Windows 可能多写一个 rn,而 _stat 统计的是磁盘上字节数,但某些工具(如记事本)显示大小时按逻辑行算。更常见的“小 1”其实是误把 st_size 当成了字符数,而文件含 UTF-8 多字节字符——st_size 永远是字节数,不是字符数。
立即学习 “C++ 免费学习笔记(深入)”;
- 别用
st_size推测字符串长度或行数,它只是元数据里的精确字节长度 - 若文件由你自己的程序创建,确认写入时用的是二进制模式(
"wb"而非"w"),避免 Windows CRT 自动转换换行符干扰大小判断 - 调试时用
ls -l(Linux/macOS)或dir(Windows cmd)交叉验证,排除工具显示误差






























