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

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

golang如何使用os.rename重命名文件_golang 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 不仅能重命名，还能将文件移动到另一个目录（前提是同个文件系统）。例如：

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

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("目标文件已存在")
}