C++如何获取文件系统的底层Inode元数据信息？stat系统调用分析

在类Unix文件系统中，Inode是存储文件核心元数据的数据结构，包含了文件的大小、权限、所有者、创建和修改时间、硬链接数量以及对应的Inode编号等信息，这些信息并不存储在文件的内容中，而是通过stat系统调用可以获取到。

stat系统调用基础介绍

stat是Linux系统提供的系统调用，用于获取指定文件路径对应的Inode元数据信息，对应的C语言标准库也提供了封装好的stat函数，在C++中可以直接调用。该函数需要包含两个头文件：<sys/stat.h>和<unistd.h>，函数原型如下：

#include <sys/stat.h>
#include <unistd.h>
// 函数原型
int stat(const char *pathname, struct stat *statbuf);

函数的第一个参数是需要查询的文件路径字符串，第二个参数是指向struct stat结构体的指针，函数执行成功后会把获取到的Inode元数据填充到这个结构体中，执行成功返回0，失败返回-1并设置errno。

struct stat结构体字段解析

struct stat结构体中包含了Inode的所有元数据字段，不同系统下的字段可能略有差异，常见的核心字段如下：

C++获取Inode元数据的完整示例

下面的代码演示了如何通过stat系统调用获取指定文件的Inode元数据，并且解析出常用的信息：

#include <iostream>
#include <sys/stat.h>
#include <unistd.h>
#include <time.h>
#include <cerrno>
#include <cstring>

// 时间转换辅助函数，将时间戳转为可读字符串
const char* format_time(time_t timestamp) {
    static char time_str[64];
    struct tm* time_info = localtime(×tamp);
    strftime(time_str, sizeof(time_str), "%Y-%m-%d %H:%M:%S", time_info);
    return time_str;
}

int main() {
    const char* file_path = "./test.txt"; // 要查询的文件路径
    struct stat file_stat;

    // 调用stat获取文件元数据
    int ret = stat(file_path, &file_stat);
    if (ret == -1) {
        std::cerr << "获取文件元数据失败，错误原因：" << strerror(errno) << std::endl;
        return 1;
    }

    // 输出Inode相关信息
    std::cout << "文件路径：" << file_path << std::endl;
    std::cout << "Inode编号：" << file_stat.st_ino << std::endl;
    std::cout << "文件大小：" << file_stat.st_size << " 字节" << std::endl;
    std::cout << "硬链接数量：" << file_stat.st_nlink << std::endl;
    std::cout << "最后访问时间：" << format_time(file_stat.st_atime) << std::endl;
    std::cout << "最后修改时间：" << format_time(file_stat.st_mtime) << std::endl;
    std::cout << "最后状态变更时间：" << format_time(file_stat.st_ctime) << std::endl;

    // 判断文件类型
    if (S_ISREG(file_stat.st_mode)) {
        std::cout << "文件类型：普通文件" << std::endl;
    } else if (S_ISDIR(file_stat.st_mode)) {
        std::cout << "文件类型：目录" << std::endl;
    } else if (S_ISLNK(file_stat.st_mode)) {
        std::cout << "文件类型：符号链接" << std::endl;
    } else {
        std::cout << "文件类型：其他类型" << std::endl;
    }

    return 0;
}

注意事项

• 如果查询的是符号链接文件，stat默认会返回符号链接指向的目标文件的元数据，如果需要获取符号链接本身的元数据，可以使用lstat系统调用，其参数和返回值和stat完全一致。
• stat函数获取的时间戳是秒级的，如果需要更高精度的时间，可以使用stat64或者系统提供的其他高精度时间接口。
• 当文件路径长度超过系统限制，或者进程没有访问该文件的权限时，stat调用会失败，需要在代码中做好错误处理。

需要注意的是，Inode是类Unix文件系统的特有概念，Windows的NTFS文件系统没有Inode的设计，因此上述方法仅在Linux、macOS等类Unix系统下有效，Windows平台无法使用stat获取对应的Inode信息。

C++stat系统调用Inode元数据文件系统修改时间：2026-06-23 08:36:37