当前位置：首页 > 文章列表 > Golang > Go教程 > Golang用os.Rename重命名文件方法

Golang用os.Rename重命名文件方法

2026-02-07 17:14:36 0浏览收藏

哈喽！大家好，很高兴又见面了，我是golang学习网的一名作者，今天由我给大家带来一篇《Golang如何用os.Rename重命名文件》，本文主要会讲到等等知识点，希望大家一起学习进步，也欢迎大家关注、点赞、收藏、转发! 下面就一起来看看吧！

os.Rename可原子重命名同文件系统内的文件或目录，需确保源存在、目标父目录存在，跨设备时需复制后删除。

如何使用Golang实现文件重命名_通过os Rename修改文件名称

使用 Go 的 os.Rename 可以快速、原子地重命名文件或目录，它底层调用操作系统对应的 rename 系统调用，效率高且在同文件系统内是原子操作。

基本用法：重命名单个文件

os.Rename 接收两个参数：源路径（oldpath）和目标路径（newpath），均为字符串。若目标路径已存在，Windows 下会报错，Linux/macOS 下会覆盖（取决于系统行为，但 Go 标准库不保证跨平台覆盖语义，应避免依赖）。

确保源文件存在，否则返回 os.ErrNotExist
目标路径的父目录必须存在，否则返回 os.ErrNotExist（如将 a.txt 重命名为 sub/b.txt，需先确保 sub/ 目录存在）
路径支持相对路径和绝对路径，建议统一用 filepath.Clean 或 filepath.Abs 规范化

安全重命名：检查与错误处理

生产代码中不应直接调用 os.Rename 后忽略错误。常见健壮写法包括：

调用前用 os.Stat 检查源文件是否存在且为普通文件
检查目标路径是否已存在，按需决定是否跳过、备份或报错
捕获并区分常见错误，例如：os.ErrNotExist、os.ErrPermission、syscall.EXDEV（跨设备移动，此时需 copy + remove）

示例片段：

if err := os.Rename("old.txt", "new.txt"); err != nil {
  if errors.Is(err, os.ErrNotExist) {
    log.Println("源文件不存在")
  } else if errors.Is(err, syscall.EXDEV) {
    log.Println("无法跨文件系统重命名，需复制后删除")
  } else {
    log.Fatal(err)
  }
}