Python中`st_mtime_ns`的实际时间分辨率是多少？

st_mtime_ns不存在全局统一的固定分辨率，Python本身不对该值做任何加工，只是直接透传操作系统和文件系统返回的时间计数，返回值单位固定为纳秒，但实际有效精度完全由运行环境决定。

常见环境的典型分辨率参考 #

以下是主流环境下的实测精度值，可以做初步参考：

• Windows系统
  • NTFS分区：有效分辨率100纳秒，这是Windows文件时间的原生精度
  • FAT/FAT32/exFAT分区：st_mtime_ns对应修改时间的有效分辨率为2秒，该文件系统下访问时间st_atime_ns分辨率仅为1天
• Linux系统
  • ext4/xfs/btrfs等原生现代文件系统：标称分辨率1纳秒，实际受内核时钟精度影响，有效精度普遍在1微秒以上
  • FAT/exFAT/ext2等老旧文件系统、NFS/SMB等网络挂载分区：分辨率从1秒到10秒不等，具体取决于挂载参数和存储端实现
• macOS系统
  • APFS原生分区：有效分辨率1纳秒
  • 第三方驱动挂载的非原生分区：精度遵循对应文件系统的原生规则

注意：所有带_ns后缀的时间属性只是避免了浮点数存储的截断误差，不会突破底层文件系统本身的精度上限，不要看到单位是纳秒就默认能达到纳秒级检测粒度。

文件修改检测场景的落地规则 #

针对检测“上次程序运行后文件是否被修改”、避免漏检查询后即刻修改的需求，不要硬编码固定阈值，按以下逻辑实现即可：

1. 程序初始化时，在待检测的目标目录下实测当前环境的mtime分辨率：连续多次快速覆写临时文件，记录两次覆写操作拿到的st_mtime_ns差值，取多次测试的最大值再翻倍留足冗余，作为当前环境的安全等待阈值。参考实现：

import os

def cal_mtime_threshold(target_dir: str = ".") -> int:
    """计算当前目录下mtime检测的安全等待阈值，单位：纳秒"""
    test_path = os.path.join(target_dir, ".mtime_calib.tmp")
    max_gap = 0
    try:
        for _ in range(10):
            with open(test_path, "w") as f:
                f.write("t1")
            t_prev = os.stat(test_path).st_mtime_ns
            with open(test_path, "w") as f:
                f.write("t2")
            t_curr = os.stat(test_path).st_mtime_ns
            gap = t_curr - t_prev
            if gap > max_gap:
                max_gap = gap
    finally:
        if os.path.exists(test_path):
            os.unlink(test_path)
    # 翻倍留冗余，规避边界调度误差
    return max_gap * 2

2. 每次完成文件状态扫描后，等待时长达到上述计算出的阈值后，再把本次扫描拿到的st_mtime_ns作为下次比对的基线值，就能完全覆盖时间戳粒度不足导致的漏检问题。
3. 如果对检测可靠性要求极高，不要只靠mtime做判断：系统时间回拨、文件被替换为旧版本等场景会出现mtime不变甚至变小的情况，可以搭配文件大小、内容哈希做二次校验。

内容的提问来源于stack exchange，提问作者Dragon