C++如何获取文件创建时间 _ filesystem::last_write_time【干货】

C++如何获取文件创建时间：绕开filesystem的“标准盲区”

std::filesystem::last_write_time 只能获取修改时间，不是创建时间

如果你在Windows平台上，想用C++标准库直接获取文件的创建时间，恐怕要失望了。C++20的std::filesystem确实提供了last_write_time和last_access_time，但偏偏没有creation_time——这不是你的用法有问题，而是标准本身就没有定义这个接口。

这里有个常见的坑：有些开发者可能会在MSVC的头文件里，偶然发现一些未公开的、类似__creation_time的成员，或者在网上找到某些“增强版”filesystem实现。千万别碰！这些都属于未定义行为，调用它们要么编译失败，要么在运行时给你带来意想不到的“惊喜”。

Windows 下必须用 GetFileTime + FILETIME 转换

那在Windows上到底该怎么拿到文件的创建时间呢？答案是绕开标准库，直接调用Windows API。核心流程其实很清晰：先用CreateFileW打开文件获取句柄，接着调用GetFileTime拿到时间结构，最后进行必要的数据转换。

这里有几个细节需要特别注意：

• GetFileTime会一次性返回三个时间：创建时间（lpCreationTime）、最后访问时间（lpLastAccessTime）和最后修改时间（lpLastWriteTime），参数顺序别搞错了。
• 它返回的FILETIME结构，其时间单位是100纳秒，计数起点是1601年1月1日（UTC）。这跟常用的time_t可不是一回事，不能直接混用。
• 如果你的目标是让返回的时间类型与std::filesystem::last_write_time保持一致（即file_clock::time_point），那么就需要进行转换。通常建议使用std::chrono::file_clock::from_sys，不过要留意，Windows上file_clock的实现可能并不完全精确。
• 错误处理是关键：务必检查CreateFileW返回的句柄是否为INVALID_HANDLE_VALUE，并且确认GetFileTime调用返回了TRUE。否则，拿到的时间数据根本不可信。

跨平台代码别硬塞 creation_time，优先降级处理

一旦涉及到跨平台，事情就变得更棘手了。Linux和macOS系统压根就没有一个POSIX标准定义的“文件创建时间”概念。虽然像ext4、xfs这类文件系统内部可能有类似crtime的字段，APFS也有记录，但它们要么不暴露给标准接口，要么行为不可靠。标准的stat结构体里，你能找到的只有st_mtime（修改时间）、st_atime（访问时间）和st_ctime（状态变更时间，注意，这也不是创建时间）。

所以，如果你试图封装一个通用的、跨平台的creation_time函数，结果大概率是在非Windows平台上返回错误的值，或者直接抛出异常。

更务实的做法是什么呢？

• 首先问清楚业务需求：是不是真的强依赖于文件的创建时间？比如是为了满足日志归档或审计合规。如果不是，那么使用last_write_time（最后修改时间）通常是更安全、更通用的选择。
• 如果确实需要支持，那就实现一个平台相关的函数：在Windows上走GetFileTime那条路，在其他平台上则回退（fallback）到返回last_write_time，并且一定要加上清晰的注释，说明这个返回值“并非真正的创建时间”。
• 在编写模板或泛型代码时尤其要小心，绝对不要假设creation_time接口存在，否则你的代码很可能在Linux的CI流水线上编译失败，或者在运行时崩溃。

一个小而完整的 Windows 创建时间读取示例

#include 
#include 
#include 

std::optional get_creation_time(const std::filesystem::path& p) {
    HANDLE h = CreateFileW(p.c_str(), GENERIC_READ, FILE_SHARE_READ,
                          nullptr, OPEN_EXISTING, FILE_ATTRIBUTE_NORMAL, nullptr);
    if (h == INVALID_HANDLE_VALUE) return std::nullopt;

    FILETIME ft_create, ft_access, ft_write;
    if (!GetFileTime(h, &ft_create, &ft_access, &ft_write)) {
        CloseHandle(h);
        return std::nullopt;
    }
    CloseHandle(h);

    // FILETIME → uint64_t → 100ns ticks since 1601 → convert to file_clock
    uint64_t ft_int = (static_cast(ft_create.dwHighDateTime) << 32) |
                      ft_create.dwLowDateTime;

    // Windows file_clock epoch is 1601-01-01 UTC, same as FILETIME
    auto tp = std::chrono::file_clock::time_point(
        std::chrono::duration_cast(
            std::chrono::nanoseconds(ft_int * 100)
        )
    );
    return tp;
}

需要注意的是，std::chrono::file_clock在MSVC中已经映射到了Windows的FILETIME时间体系。但是，在Windows上使用GCC或Clang编译时，这个实现可能还不完整。在这种情况下，你可以考虑改用system_clock并做好时区校正，或者干脆直接返回FILETIME的原始值，让上层调用者自己去判断和处理。

最后提一个最容易忽略，但也至关重要的点：在NTFS卷上，文件的创建时间并不是一个“一成不变”的神圣属性。当文件被复制、移动或从压缩包解压时，这个时间戳很可能会被重置——具体行为取决于执行这些操作的工具。所以，千万别把创建时间当作唯一可信的、具有强语义保证的时间戳来使用。