如何在Go语言中实现文件安全替换写入-Golang-PHP中文网

直接os.writefile不安全，因其先清空原文件再写入，崩溃或断电会导致原文件永久丢失；安全替换必须用临时文件+os.rename原子重命名，且需确保同文件系统、权限继承、错误回滚。

如何在go语言中实现文件安全替换写入

为什么直接 `os.WriteFile` 不算安全替换

直接覆盖原文件（比如用 os.WriteFile）在写入中途崩溃或断电时，原文件内容会永久丢失——它不是原子操作。Linux/macOS 上没有“覆盖即原子”的保证，Windows 更是会先清空再写入。真正的安全替换必须依赖“先写新文件 + 原子重命名”这一组合。

用 `os.Rename` 实现原子替换的关键约束

os.Rename 在同一文件系统内才是原子的；跨分区、跨挂载点会失败（syscall.EXDEV）。所以必须确保临时文件和目标路径在同一个磁盘/挂载点上：

临时文件应创建在目标文件所在目录（而非 /tmp），例如用 filepath.Join(filepath.Dir(dst), "tmp-xxx")
务必检查 os.Rename 返回的错误：若为 syscall.EXDEV，需 fallback 到拷贝 + 删除（无法原子，但至少保留原文件直到最后一步）
临时文件权限要继承原文件（用 os.Stat 读取 Mode()），否则替换后可能丢掉可执行位或导致权限收紧

完整可复用的替换函数示例

以下函数处理了权限继承、同盘检测、错误回滚（删除临时文件）等关键点：

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本官方下载，版本号 1.26.0，适合旧项目维护、兼容性测试和指定版本开发环境搭建。

下载

func SafeWriteFile(dst string, data []byte) error {
	fi, err := os.Stat(dst)
	if err != nil && !os.IsNotExist(err) {
		return err
	}
	mode := os.FileMode(0644)
	if err == nil {
		mode = fi.Mode()
	}

	dir := filepath.Dir(dst)
	tmp, err := os.CreateTemp(dir, ".tmp-*")
	if err != nil {
		return err
	}
	defer os.Remove(tmp.Name()) // 确保失败时清理

	if _, err := tmp.Write(data); err != nil {
		tmp.Close()
		return err
	}
	if err := tmp.Chmod(mode); err != nil {
		tmp.Close()
		return err
	}
	if err := tmp.Close(); err != nil {
		return err
	}

	if err := os.Rename(tmp.Name(), dst); err != nil {
		if errors.Is(err, syscall.EXDEV) {
			// fallback: copy + remove
			if err2 := CopyFile(tmp.Name(), dst); err2 != nil {
				return err2
			}
			return os.Remove(tmp.Name())
		}
		return err
	}
	return nil
}