Go os.Rename 怎样实现同目录文件替换

如果目标是把一份新内容完整替换到同目录的旧文件，推荐的做法是：先用 os.CreateTemp 在目标目录创建临时文件，写完并关闭它，再调用 os.Rename(tempPath, targetPath)。不要先删除旧文件再写新文件，否则读者可能看到短暂的不存在状态或半成品。

官方资料：https://pkg.go.dev/os

在同一目录里，临时文件和目标文件位于同一个文件系统边界，最后一次改名负责切换目标路径。Unix 上替换普通文件通常具有原子切换语义；Go 官方同时提醒，非 Unix 平台即使同目录也不保证 Rename 是原子操作。

同目录替换到底替换了什么

os.Rename 的语义是移动或改名：当新路径已经存在且不是目录时，它会替换该路径；如果新路径是目录，则返回错误。所谓“同目录替换”，不是把旧文件内容原地覆盖，而是让目标路径改为指向已经写完的临时文件。

把临时文件放在目标目录还有两个好处：不会因为跨文件系统移动而失败，也能让最后一次路径切换落在同一个目录项上。不要把临时文件放到系统临时目录后再跨目录 Rename，并把这种写法误认为同目录原子替换。

先写临时文件，再切换目标路径

下面的函数把“写入”和“发布”分开。defer 中的删除只负责清理尚未成功改名的临时文件；改名成功后，临时路径已经不存在，删除失败会被忽略。

package replacefile

import (
    "fmt"
    "os"
    "path/filepath"
)

// ReplaceInDir 先完成临时文件写入，再替换同目录中的目标文件。
func ReplaceInDir(dir, name string, data []byte) error {
    target := filepath.Join(dir, name)

    // 临时文件必须创建在目标目录，避免跨文件系统改名。
    f, err := os.CreateTemp(dir, ".replace-*")
    if err != nil {
        return fmt.Errorf("create temp file: %w", err)
    }
    temp := f.Name()
    defer func() {
        // 改名成功后 temp 已不存在；失败时删除残留临时文件。
        _ = os.Remove(temp)
    }()

    // Write 返回的字节数也要检查，错误不能只看文件是否创建。
    if _, err := f.Write(data); err != nil {
        _ = f.Close()
        return fmt.Errorf("write temp file: %w", err)
    }
    // Sync 只表达把文件数据交给操作系统的意图，不等同于所有平台的断电保证。
    if err := f.Sync(); err != nil {
        _ = f.Close()
        return fmt.Errorf("sync temp file: %w", err)
    }
    // 先关闭句柄，再改名，避免平台相关的共享和锁限制。
    if err := f.Close(); err != nil {
        return fmt.Errorf("close temp file: %w", err)
    }
    if err := os.Rename(temp, target); err != nil {
        return fmt.Errorf("rename %q to %q: %w", temp, target, err)
    }
    return nil
}

这个实现没有先调用 os.Remove(target)。如果新内容写失败，旧文件仍然存在；如果改名失败，也能通过返回的 *os.LinkError 区分出操作、旧路径和新路径，日志更容易定位。

替换成功不等于所有持有者都看到新内容

路径替换和文件句柄是两个层次。Unix 下，已经打开旧文件的读取者通常继续读旧文件对象；之后重新按目标路径打开的读取者才会拿到新文件。这个特性适合配置文件、清单文件等“整文件发布”场景，但不能替代进程间锁或版本协调。

如果目标路径是目录，os.Rename 不会把目录当作普通文件覆盖。跨目录时还可能受到操作系统和文件系统限制；即使路径看起来属于同一磁盘，也不要把跨目录行为当作可移植的原子替换方案。

失败时如何保留旧文件

最重要的顺序是“先产生新文件，再尝试切换路径”。写入、同步、关闭任一步失败，都只清理临时文件；只有 os.Rename 成功后，才把这次写入视为发布完成。

如果业务还要求断电后也尽量保住目录项更新，需要结合目标操作系统提供的目录同步能力；可移植的 os 示例不应把一次 File.Sync 夸大成完整的持久化协议。

常见问题

为什么不直接 WriteFile 覆盖目标文件？

直接写目标路径会让读者有机会看到截断或半写入内容。临时文件加 Rename 能把不完整状态隔离在临时路径中，更适合需要整文件切换的场景。

是否应该先删除旧文件？

通常不应该。先删除会制造目标路径短暂不存在的窗口，也让写入失败时无法保留旧版本。让 Rename 负责替换普通文件即可。

总结：临时文件放在目标目录，写完后检查 Write、Sync、Close，再用一次 os.Rename 切换路径；清理逻辑只处理失败残留，并对 Unix 原子性与非 Unix 限制保持明确边界。