std::filesystem::last_write_time() 无法可靠获取微秒级修改时间,因其精度由实现定义且主流编译器仅对齐到秒或100ns;跨平台微秒精度需绕过标准库,直接调用stat()(Linux/macOS)或GetFileTime()(Windows)并手动解析。

C++ 标准库 std::filesystem 无法获取微秒级修改时间 —— 它只暴露到秒(std::filesystem::file_time_type 的精度由实现定义,但主流编译器(GCC/Clang/MSVC)目前均仅对齐到系统时钟最低有效位,通常是 100ns 或 1s,且不保证跨平台可读为微秒)。
为什么 last_write_time() 看起来“有纳秒”但实际不可靠
调用 std::filesystem::last_write_time(path) 返回的是 std::filesystem::file_time_type,它底层常映射为 std::chrono::time_point,其 duration 类型可能是 std::chrono::nanoseconds。但这只是“存储单位”,不代表文件系统真的记录了纳秒或微秒精度:
- Linux ext4/xfs:通常只支持纳秒(
st_mtim.tv_nsec),但内核和 glibc 可能向下取整或受硬件时钟限制 - Windows NTFS:时间戳以 100ns 为单位(即 0.1 微秒),但
GetFileTime()返回值需手动组合,C++ 标准库未暴露原始FILETIME - macOS APFS/HFS+:支持纳秒,但
stat()中st_mtimespec是结构体,标准库不透出该字段
更关键的是:std::filesystem::file_time_type 的 epoch 和转换逻辑未标准化,直接用 .time_since_epoch().count() 取值可能得到无意义的大整数(比如 Windows 上是自 1601-01-01 的 100ns tick,Linux 是自 1970-01-01 的纳秒 —— 但 std::filesystem 不承诺这个)。
跨平台获取微秒级修改时间的可行方案
必须绕过 std::filesystem,直接调用系统 API 并手动解析:
- Linux/macOS:用
stat()+st_mtim.tv_nsec(注意:tv_nsec是纳秒,除以 1000 得微秒,但需检查是否被截断;部分旧文件系统可能只存 1s 或 1ms) - Windows:用
GetFileTime()获取LPFILETIME,再转为 100ns 单位的 64 位整数,除以 10 得微秒(因为 1 微秒 = 10 × 100ns) - 不要依赖
std::filesystem::file_time_type::period—— 它在不同平台返回不同类型(ratio或ratio),且无法安全反推原始精度
示例(Linux/macOS):
#include <sys>
#include <cstdint><p>int64_t get_mtime_us(const char<em> path) {
struct stat st;
if (stat(path, &st) != 0) return -1;
return static_cast<int64_t>(st.st_mtim.tv_sec) </int64_t></em> 1000000LL +
st.st_mtim.tv_nsec / 1000; // 转微秒,向下取整
}
</p></cstdint></sys>
示例(Windows):
#include <windows.h>
#include <cstdint><p>int64_t get_mtime_us(const wchar_t* path) {
HANDLE h = CreateFileW(path, GENERIC_READ, FILE_SHARE_READ, nullptr,
OPEN_EXISTING, FILE_ATTRIBUTE_NORMAL, nullptr);
if (h == INVALID_HANDLE_VALUE) return -1;</p>
<pre class="brush:php;toolbar:false;">FILETIME ft;
if (!GetFileTime(h, nullptr, nullptr, &ft)) {
CloseHandle(h);
return -1;
}
CloseHandle(h);
ULARGE_INTEGER ui;
ui.LowPart = ft.dwLowDateTime;
ui.HighPart = ft.dwHighDateTime;
return static_cast<int64_t>(ui.QuadPart / 10); // 100ns → μs</int64_t>
}
用 std::filesystem::last_write_time() 做时间比较?可以,但别解析精度
如果你只需要判断“文件 A 是否比 B 新”,直接用 std::filesystem::last_write_time(a) > std::filesystem::last_write_time(b) 是安全且跨平台的 —— 比较操作符已重载,内部按等效时间点处理,不依赖用户解析精度。
- 不要对返回值调用
.time_since_epoch().count()后做算术运算(比如减法求差值),因为 epoch 不统一 - 不要用
std::chrono::system_clock::from_time_t()转换 ——file_time_type和system_clock无标准转换路径 - 若必须转为可读时间字符串,用
std::filesystem::file_time_type到std::time_t的隐式转换(C++20 起支持),再用std::gmtime或std::localtime—— 但会丢失亚秒部分
真正要微秒,就得亲手碰 stat() 或 GetFileTime();指望 std::filesystem 统一抽象微秒精度,目前只是幻觉。最易被忽略的是:即使系统 API 返回了纳秒,硬盘控制器、文件系统日志、甚至 NFS 服务端都可能抹掉低位 —— 所谓“微秒时间”,常常只是格式对齐,不是真实精度。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











