Go os.Chtimes 修改符号链接时间为什么不等于目标文件

先给结论：os.Chtimes 接收的是路径名，遇到符号链接时会沿着链接找到目标文件，并修改目标文件的访问时间与修改时间；它不是“修改链接自身时间”的接口。因此，调用成功后用 os.Stat 查看目标文件发生变化，而用 os.Lstat 查看符号链接自身时，结果可能和预期不同。

官方文档地址：https://pkg.go.dev/os#Chtimes

排查这类问题时，把“调用对象”和“观察对象”分开最重要：Stat 跟随符号链接，Lstat 保留链接自身；atime 和 mtime 还可以分别用零值表示“不修改”。

先给结论：Chtimes 跟随链接改的是目标对象

符号链接包含的是一个指向目标路径的入口。把链接路径传给 os.Chtimes 时，操作语义关注的是这个路径最终解析到的文件对象，所以修改结果应到目标文件的时间字段上查找。链接本身的 ModTime 不会因为这次调用而自动变成同一个值。

用 Stat 与 Lstat 分开观察两个 FileInfo

不要只调用一次 Stat 就断言“链接被修改了”。Stat 会把链接解析到目标对象；如果要判断路径本身是不是符号链接，应该使用 Lstat，再通过 Mode()&os.ModeSymlink 判断文件类型。

package main

import (
    "fmt"
    "os"
)

func inspect(path string) error {
    // Stat 跟随符号链接，返回目标文件的信息。
    target, err := os.Stat(path)
    if err != nil {
        return fmt.Errorf("读取目标文件信息失败: %w", err)
    }

    // Lstat 不跟随符号链接，返回链接自身的信息。
    link, err := os.Lstat(path)
    if err != nil {
        return fmt.Errorf("读取链接自身信息失败: %w", err)
    }

    fmt.Println("目标:", target.Name(), target.ModTime())
    fmt.Println("路径对象:", link.Name(), link.ModTime())
    fmt.Println("是否为符号链接:", link.Mode()&os.ModeSymlink != 0)
    return nil
}

这段代码只负责建立观察层次，不把两个 FileInfo 混在一起。若 link.Mode()&os.ModeSymlink 为真，就说明输入路径是链接；此时 target.ModTime() 和 link.ModTime() 代表两个不同对象的字段。

按 atime、mtime 和零值参数组织调用

Chtimes 的第二、第三个参数分别是访问时间和修改时间。某个参数使用零值 time.Time{} 时，表示保留该时间字段；这适合只更新 mtime 而不触碰 atime 的场景。

package main

import (
    "fmt"
    "os"
    "time"
)

func updateModifiedTime(path string, modified time.Time) error {
    // 零值 atime 表示保留原访问时间，只更新修改时间。
    if err := os.Chtimes(path, time.Time{}, modified); err != nil {
        return fmt.Errorf("更新目标文件时间失败: %w", err)
    }
    return nil
}

调用成功只说明系统接受了这次元数据操作，不代表所有文件系统都能保存纳秒级精度。官方文档也提示底层文件系统可能截断或舍入时间；如果业务需要精确比较，应先定义允许的精度范围，而不是直接比较两个时间值是否完全相等。

处理平台精度、权限和链接自身时间边界

如果返回的是 *os.PathError，先区分路径不存在、权限不足和文件系统不支持。权限检查应覆盖目标文件及其父目录的实际能力；不要因为路径文字中包含链接，就假设可以用同一个便携接口修改链接自身时间。

如果需求是“改目标文件时间”，使用 Chtimes 加 Stat 观察即可；如果需求是“改符号链接自身时间”，则需要确认目标平台和底层系统是否提供不跟随链接的专用能力。本文不把某个 Unix 专用调用包装成跨平台 Go 标准库方案。

还有一个容易遗漏的边界：链接目标被替换后，同一个链接路径可能指向另一个文件。排查记录中应同时保存路径、Stat 得到的目标信息和 Lstat 得到的链接信息，不能只保存一份 ModTime。

发布前检查清单与常见问题

1. 调用目标是目标文件，还是希望操作符号链接自身？
2. 验证目标时是否使用了 Stat，验证链接时是否使用了 Lstat？
3. 是否明确了 atime 或 mtime 哪个字段要保留？
4. 是否接受底层文件系统对时间精度的截断或舍入？
5. 是否把 *os.PathError 的路径和操作信息保留下来？

为什么 Chtimes 成功后链接的 ModTime 没变？

因为 Chtimes 沿符号链接操作目标文件。用 Lstat 读到的是链接自身，和用 Stat 读到的目标文件不是同一个对象。

怎样只更新修改时间？

把访问时间参数传成 time.Time{}，把新的时间放到 mtime 参数；同时要接受文件系统可能降低时间精度。

把“路径解析”“目标修改”和“对象观察”拆开，os.Chtimes 的结果就不会再被符号链接的两层元数据混淆。