stat()是Linux/macOS获取inode号的标准方法,通过struct stat的st_ino字段;Windows无inode,可用GetFileInformationByHandle()组合nFileIndexHigh/Low模拟,但需先CreateFile()获取句柄。

Linux/macOS下用stat()获取inode号
在类Unix系统上,inode是文件系统内部标识文件的唯一编号,stat()是最直接、最标准的方式。它不依赖路径是否可读或执行权限,只依赖路径是否存在且有搜索权限(即目录的x位)。
关键点:stat()填充的struct stat里,st_ino字段就是inode号;注意它类型是ino_t,通常为unsigned long,打印时用%lu或std::to_string()更安全。
- 头文件必须包含
<sys/stat.h>(Linux/macOS)和<unistd.h>(部分函数需要) - 传入路径字符串,不能是空指针或非法路径,否则
stat()返回-1,errno设为ENOENT或EACCES - 若需获取符号链接本身(而非目标)的inode,改用
lstat()
#include <sys/stat.h>
#include <iostream>
<p>ino_t get_inode(const char* path) {
struct stat sb;
if (stat(path, &sb) == 0) {
return sb.st_ino;
}
return 0; // 失败时返回0(inode号不可能为0)
}Windows下没有等价inode,但可用BY_HANDLE_FILE_INFORMATION
Windows没有inode概念,但NTFS有类似唯一标识:通过GetFileInformationByHandle()获取的dwVolumeSerialNumber + nFileIndexHigh + nFileIndexLow三元组,在同一卷内可唯一标识文件(类似inode语义)。
注意这不是跨卷稳定的ID,也不能用于硬链接检测——Windows硬链接靠FindFirstFileNameW()查别名,不是靠索引号。
立即学习“C++免费学习笔记(深入)”;
组合式C++代码评审方案,融合静态分析、AI推理、多轮迭代评审和C++专项检查,适用于PR审查、增量代码审查、全项目评审和代码质量评分,触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 必须先用
CreateFile()打开文件(哪怕只用GENERIC_READ和FILE_SHARE_*),不能直接传路径给GetFileInformationByHandle() - 返回结构体中
nFileIndexHigh和nFileIndexLow需组合成64位整数:((uint64_t)fi.nFileIndexHigh << 32) | fi.nFileIndexLow - 失败时
GetLastError()可能返回ERROR_SHARING_VIOLATION(文件被独占打开)、ERROR_ACCESS_DENIED(权限不足)等
C++跨平台封装要注意路径和错误处理
想写一次代码跑两边,不能简单宏替换stat/GetFileInformationByHandle——两套API行为差异大:一个接受路径字符串,一个需要句柄;一个失败返回-1,一个失败返回FALSE并设GetLastError()。
- 统一返回类型建议用
std::optional<uint64_t>(C++17),成功时存inode或file index,失败时为空 - Windows路径分隔符不影响
CreateFile(),它接受/和,但注意\?前缀用于长路径(超过MAX_PATH) - 不要用
std::filesystem::status()或std::filesystem::symlink_status()取inode——它们底层调用stat()或lstat(),但C++标准没暴露st_ino字段,无法提取
常见错误:误把设备号当inode,或忽略符号链接跳转
调用stat()后,有人会顺手打印sb.st_dev(设备号),以为是inode——这是典型混淆。真正要的是sb.st_ino;而st_dev只是该inode所在文件系统的ID。
另一个坑是默认用stat()却没意识到它会跟随符号链接:如果路径是软链,拿到的是目标文件的inode,不是链接本身的。要获取链接自身的inode,必须用lstat()。
- 硬链接共享同一个inode,所以多个路径
stat()结果的st_ino相同 - 不同分区的文件即使同名,
st_dev一定不同,st_ino可能重复(因为各分区inode空间独立) - 某些网络文件系统(如NFSv3)可能不保证
st_ino稳定,此时应避免用inode做长期缓存key
跨平台时最易被忽略的是:Windows没有lstat()对应物,CreateFile()打开符号链接时默认解析目标;若要获取链接文件自身信息,得用FILE_FLAG_OPEN_REPARSE_POINT标志。

















