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></sys>(Linux/macOS)和<unistd.h></unistd.h>(部分函数需要) - 传入路径字符串,不能是空指针或非法路径,否则
stat()返回-1,errno设为ENOENT或EACCES - 若需获取符号链接本身(而非目标)的inode,改用
lstat()
#include <sys>
#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)
}</p></iostream></sys>
Windows下没有等价inode,但可用BY_HANDLE_FILE_INFORMATION
Windows没有inode概念,但NTFS有类似唯一标识:通过GetFileInformationByHandle()获取的dwVolumeSerialNumber + nFileIndexHigh + nFileIndexLow三元组,在同一卷内可唯一标识文件(类似inode语义)。
注意这不是跨卷稳定的ID,也不能用于硬链接检测——Windows硬链接靠FindFirstFileNameW()查别名,不是靠索引号。
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1),免gas,支持macOS/Linux/Windows。触发词:/r
- 必须先用
CreateFile()打开文件(哪怕只用GENERIC_READ和FILE_SHARE_*),不能直接传路径给GetFileInformationByHandle() - 返回结构体中
nFileIndexHigh和nFileIndexLow需组合成64位整数:((uint64_t)fi.nFileIndexHigh - 失败时
GetLastError()可能返回ERROR_SHARING_VIOLATION(文件被独占打开)、ERROR_ACCESS_DENIED(权限不足)等
C++跨平台封装要注意路径和错误处理
想写一次代码跑两边,不能简单宏替换stat/GetFileInformationByHandle——两套API行为差异大:一个接受路径字符串,一个需要句柄;一个失败返回-1,一个失败返回FALSE并设GetLastError()。
- 统一返回类型建议用
std::optional<uint64_t></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标志。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!










