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 可能多写一个 \r\n，而 _stat 统计的是磁盘上字节数，但某些工具（如记事本）显示大小时按逻辑行算。更常见的“小 1”其实是误把 st_size 当成了字符数，而文件含 UTF-8 多字节字符——st_size 永远是字节数，不是字符数。
立即学习“C++免费学习笔记（深入）”；
- 别用
st_size推测字符串长度或行数，它只是元数据里的精确字节长度 - 若文件由你自己的程序创建，确认写入时用的是二进制模式（
"wb"而非"w"），避免 Windows CRT 自动转换换行符干扰大小判断 - 调试时用
ls -l（Linux/macOS）或dir（Windows cmd）交叉验证，排除工具显示误差
