Golang如何使用os.Rename重命名文件_Golang Rename文件重命名操作方法

os.Rename可用于文件或目录重命名及移动，要求同文件系统且目标路径不存在，否则报错；跨设备需结合复制和删除操作。

在 Go 语言中，使用 os.Rename 可以轻松实现文件或目录的重命名操作，也可以用于移动文件。这个函数属于标准库中的 os 包，使用时无需引入第三方依赖。

基本用法：os.Rename(oldpath, newpath)

os.Rename 接受两个参数：

• oldpath：原文件（或目录）路径
• newpath：目标路径（新文件名或新位置）

如果目标路径已存在，操作会失败并返回错误。成功则返回 nil。

示例代码：

package main

import (
    "log"
    "os"
)

func main() {
    err := os.Rename("oldfile.txt", "newfile.txt")
    if err != nil {
        log.Fatal(err)
    }
}

跨目录移动文件

os.Rename 不仅能重命名，还能将文件移动到另一个目录（前提是同个文件系统）。例如：

err := os.Rename("data/backup.log", "archive/backup_2025.log")
if err != nil {
    log.Fatal(err)
}

这会把文件从 data 目录移到 archive 目录，并更改名称。

注意事项和常见问题

• 目标路径不能已存在，否则会报错：file exists
• 跨磁盘或不同文件系统重命名会失败，此时需要先复制再删除原文件
• 确保程序对源文件和目标目录有读写权限
• 重命名目录也适用该方法

可以先检查目标文件是否存在来避免错误：

if _, err := os.Stat("newfile.txt"); os.IsNotExist(err) {
    err = os.Rename("oldfile.txt", "newfile.txt")
    if err != nil {
        log.Fatal(err)
    }
} else {
    log.Println("目标文件已存在")
}

总结

os.Rename 是 Golang 中最直接的文件重命名方式，适用于大多数本地文件操作场景。只要注意路径合法性、文件是否存在以及权限问题，就能安全使用。对于复杂情况（如跨设备移动），需结合 os.CopyFile 和 os.Remove 手动实现。

基本上就这些，不复杂但容易忽略细节。