Go os.File区分同盘 Rename 与跨盘移动的兼容边界

把文件从上传目录移到归档盘时，直接调用 os.Rename 往往在同一文件系统内工作正常，一旦目标路径落在另一块挂载点，就可能返回跨设备错误。稳妥的兼容策略不是无条件复制，而是先保留 Rename 的快速路径，只有明确遇到跨文件系统限制时，才在目标目录创建临时文件完成复制、刷盘和替换。

官方地址：https://pkg.go.dev/os

先把 Rename 的边界写进迁移表

Go 官方文档把 Rename(oldpath, newpath) 定义为重命名或移动，并明确提示操作系统可能对不同目录施加限制。在 Unix 系统上，不同挂载点通常会由底层返回 EXDEV；Windows 的跨卷限制也不应被业务代码当作“所有平台都能复制”的保证。这里的“同盘”更准确地说是同一文件系统，盘符或挂载点只是便于排查的外部表现。

跨盘移动采用目标目录临时文件方案

关键点有两个：临时文件必须创建在目标文件的同一目录，这样最后一次 os.Rename 仍处于同一文件系统；复制完成后先调用 Sync，再关闭文件，避免把尚未刷出的句柄直接当成已提交结果。下面的函数只在 os.Rename 明确返回 syscall.EXDEV 时切换复制路径。

package mover

import (
    "errors"
    "fmt"
    "io"
    "os"
    "path/filepath"
    "syscall"
)

// Move 先走 Rename，只有跨文件系统时才复制到目标目录。
func Move(srcPath, dstPath string) error {
    if err := os.Rename(srcPath, dstPath); err == nil {
        return nil
    } else if !errors.Is(err, syscall.EXDEV) {
        // 权限、目标目录等其他错误不能被误判为可复制。
        return fmt.Errorf("rename %s -> %s: %w", srcPath, dstPath, err)
    }
    return copyAcrossFilesystems(srcPath, dstPath)
}

func copyAcrossFilesystems(srcPath, dstPath string) (err error) {
    src, err := os.Open(srcPath)
    if err != nil {
        return fmt.Errorf("open source: %w", err)
    }
    defer src.Close() // 复制或读取失败时仍释放源句柄。

    info, err := src.Stat()
    if err != nil {
        return fmt.Errorf("stat source: %w", err)
    }
    if info.IsDir() {
        return fmt.Errorf("source is a directory: %s", srcPath)
    }

    dir := filepath.Dir(dstPath)
    tmp, err := os.CreateTemp(dir, ".move-*" )
    if err != nil {
        return fmt.Errorf("create destination temporary file: %w", err)
    }
    tmpPath := tmp.Name()
    committed := false
    defer func() {
        if !committed {
            _ = os.Remove(tmpPath) // 未提交的临时文件可以安全清理。
        }
    }()

    if err = tmp.Chmod(info.Mode().Perm()); err != nil {
        _ = tmp.Close()
        return fmt.Errorf("copy mode: %w", err)
    }
    if _, err = io.Copy(tmp, src); err != nil {
        _ = tmp.Close()
        return fmt.Errorf("copy content: %w", err)
    }
    if err = tmp.Sync(); err != nil {
        _ = tmp.Close()
        return fmt.Errorf("sync destination: %w", err)
    }
    if err = tmp.Close(); err != nil {
        return fmt.Errorf("close destination: %w", err)
    }
    if err = os.Rename(tmpPath, dstPath); err != nil {
        return fmt.Errorf("commit destination: %w", err)
    }
    committed = true
    if err = os.Remove(srcPath); err != nil {
        return fmt.Errorf("remove source after commit: %w", err)
    }
    return nil
}

这段代码的成功语义是“目标已提交且源已删除”。如果最后一步删除源文件失败，函数返回错误，但目标文件已经存在，调用方不能简单地从头复制；应记录源、目标和错误，下一次先判断两边状态。

迁移时不要把复制路径伪装成原子移动

os.Rename 的快速路径可以在同一文件系统内提供较强的切换语义；跨文件系统复制则必然经历目标文件逐步写入的阶段。目标路径若被读线程直接消费，应该使用临时文件名隔离未完成内容，并把最终 Rename 作为可见性切换。

覆盖策略也要提前决定。官方文档说明目标已存在且不是目录时，Rename 在部分平台会替换它；如果业务不允许覆盖，就在提交前使用独占创建、版本化文件名或额外的目标存在检查。检查和提交之间仍可能有竞态，不能把普通的 Stat 检查当成并发锁。

回归检查集中在四个失败状态

1. 同目录同文件系统：确认直接 Rename 成功，源路径消失，目标内容不变。
2. 跨挂载点：确认第一次 Rename 返回跨设备错误后才进入复制，目标临时文件不会暴露给消费者。
3. 复制中断或目标空间不足：确认临时文件清理，源文件仍可重试。
4. 目标提交成功但源删除失败：确认返回错误并保留两边记录，运维处理不能重复覆盖目标。

最终迁移清单可以压缩成一句判断：能用 Rename 就不要复制；必须复制时，临时文件放在目标目录，复制后 Sync 和 Close，再 Rename 提交；源文件删除是独立的收尾动作，不能从原子性承诺中省略说明。

相关问题

为什么不能所有文件都直接 io.Copy

复制会重新读取和写入全部内容，耗时、空间和失败窗口都更大；同文件系统内 Rename 通常更适合做快速切换。

临时文件为什么一定要放在目标目录

最后的 Rename 需要在同一文件系统内完成，放在源目录再跨盘移动，仍会回到原来的兼容问题。

复制结束后只 Close 不 Sync 可以吗

Close 负责释放句柄，不等价于把数据持久化到存储介质；对需要明确落盘边界的场景，应在 Close 前调用 Sync，并把代价纳入性能设计。