Python3 os.rename() 方法（手把手讲解）

Python3 os.rename() 方法详解：文件重命名的实用指南

在日常开发中，我们常常需要对文件进行重命名操作。无论是整理项目目录、批量处理文件名，还是自动化脚本中的文件管理，Python 提供了简洁高效的解决方案。其中，os.rename() 方法就是实现文件重命名的核心工具之一。它属于 Python 标准库中的 os 模块，功能稳定、使用简单，是每个 Python 开发者都应掌握的基础技能。

与手动在操作系统中右键重命名不同，通过 os.rename() 可以在代码中自动化完成这一操作，尤其适合批量处理或集成到更大程序中。接下来，我们将从基础用法到高级技巧，一步步带你掌握这个实用方法。

基本语法与参数说明

os.rename() 方法的语法如下：

os.rename(src, dst)

src：源文件或目录的路径（字符串类型），即要重命名的原始文件。
dst：目标路径（字符串类型），即新名称或新位置。

这个方法的作用是将 src 所指向的文件或目录移动并重命名为 dst。如果 dst 已存在，则会抛出 FileExistsError 异常，因此在使用前要特别注意路径是否冲突。

📌 小贴士：os.rename() 在底层调用的是操作系统的 rename() 系统调用，因此它的行为在不同系统上基本一致，但在 Windows 和 Linux 上有一些细微差异（例如跨盘符重命名的限制），需要留意。

简单示例：单个文件重命名

我们先来看一个最基础的例子，将一个名为 old_file.txt 的文件重命名为 new_file.txt。

import os

old_path = "old_file.txt"
new_path = "new_file.txt"

os.rename(old_path, new_path)

print("文件已成功重命名为 new_file.txt")

代码注释：

第 1 行导入 os 模块，这是使用 os.rename() 的前提。
第 4 行定义原始文件路径，确保该文件存在，否则会报错。
第 7 行调用 os.rename()，传入源路径和目标路径。
第 10 行输出成功信息，用于调试或确认操作完成。

⚠️ 注意：如果 new_file.txt 已存在，程序会抛出 FileExistsError。建议在调用前先检查目标路径是否存在，避免意外覆盖。

重命名目录与跨路径移动

os.rename() 不仅能重命名文件，还能用于重命名目录，甚至将文件或目录从一个位置移动到另一个位置。

案例：将文件夹重命名为新名称

import os

old_dir = "backup_2023"
new_dir = "backup_2024"

os.rename(old_dir, new_dir)

print(f"目录 {old_dir} 已重命名为 {new_dir}")

代码注释：

这里 old_dir 和 new_dir 都是目录名，os.rename() 会自动识别并处理目录重命名。
该操作等同于在文件管理器中右键重命名文件夹。

案例：将文件移动到其他目录并重命名

import os

src_file = "documents/report.docx"
dst_file = "archive/reports/annual_report_2024.docx"

os.rename(src_file, dst_file)

print("文件已移动并重命名为 annual_report_2024.docx")

代码注释：

dst_file 包含完整的路径和新文件名，说明我们不仅重命名，还移动到了新的目录。
如果 archive/reports/ 目录不存在，会报错。因此在实际使用中，应先确保目标路径存在，或使用 os.makedirs() 创建目录。

错误处理与异常管理

在使用 os.rename() 时，常见的异常有以下几种：

异常类型	触发条件
`FileExistsError`	目标路径已存在
`FileNotFoundError`	源文件或目录不存在
`PermissionError`	无权限访问源或目标路径
`IsADirectoryError`	源是目录但目标是文件（或反之）

为避免程序因异常中断，推荐使用 try-except 块进行异常捕获。

import os

src = "data/temp.txt"
dst = "data/processed/data_final.txt"

try:
    os.rename(src, dst)
    print("文件重命名成功！")
except FileExistsError:
    print("错误：目标文件已存在，请先删除或重命名目标文件。")
except FileNotFoundError:
    print("错误：源文件不存在，请检查路径是否正确。")
except PermissionError:
    print("错误：没有权限执行重命名操作，请检查文件权限。")
except Exception as e:
    print(f"未知错误：{e}")

代码注释：

通过 try-except 捕获常见异常，提升程序健壮性。
针对不同异常给出具体提示信息，帮助开发者快速定位问题。
Exception as e 用于捕获其他未预见到的错误，便于调试。

实际应用场景：批量重命名文件

在真实项目中，我们经常需要批量重命名一组文件。比如，将一批图片按日期命名，或统一修改文件扩展名。

案例：批量将 `.jpg` 文件改为 `.jpeg`

import os

directory = "images"

for filename in os.listdir(directory):
    # 检查是否为 .jpg 文件
    if filename.lower().endswith(".jpg"):
        # 构造新文件名
        new_filename = filename.replace(".jpg", ".jpeg")
        # 构造完整路径
        old_path = os.path.join(directory, filename)
        new_path = os.path.join(directory, new_filename)
        
        # 执行重命名
        try:
            os.rename(old_path, new_path)
            print(f"已重命名：{filename} → {new_filename}")
        except FileExistsError:
            print(f"跳过：{new_filename} 已存在")
        except Exception as e:
            print(f"重命名失败：{filename}，错误：{e}")

代码注释：

os.listdir(directory) 获取目录下所有文件名。
filename.lower().endswith(".jpg") 用于不区分大小写的匹配。
os.path.join() 安全地拼接路径，避免路径错误。
使用 replace() 替换扩展名，实现格式转换。
每个重命名操作都加上异常处理，防止一个失败导致全部中断。

重命名时的路径规范与注意事项

在使用 os.rename() 时，路径问题是最常见的坑。以下是几个关键注意事项：

路径必须为字符串：不能传入 Path 对象（如 pathlib.Path），否则会报错。
路径分隔符：Windows 使用反斜杠 \，Unix/Linux 使用正斜杠 /。建议使用 os.path.join() 或 pathlib 构建路径，避免手动拼接。
跨盘符移动限制：在 Windows 上，os.rename() 无法跨盘符移动文件（如从 C:\ 移动到 D:\）。此时应使用 shutil.move() 替代。
权限问题：确保程序有读写目标路径的权限，尤其是在系统目录或受保护文件夹中。

💡 形象比喻：os.rename() 就像在文件系统中“剪切 + 粘贴”文件，但仅限于同一磁盘内。如果跨盘，就得用“复制 + 删除”方式，这正是 shutil.move() 的作用。

总结与最佳实践

通过本文的学习，我们系统掌握了 Python3 os.rename() 方法 的使用方式。它是一个轻量、高效且功能明确的文件重命名工具，适用于大多数本地文件管理场景。

Python3 os.rename() 方法详解：文件重命名的实用指南

基本语法与参数说明

简单示例：单个文件重命名

重命名目录与跨路径移动

案例：将文件夹重命名为新名称

案例：将文件移动到其他目录并重命名

错误处理与异常管理

实际应用场景：批量重命名文件

案例：批量将 .jpg 文件改为 .jpeg

重命名时的路径规范与注意事项

总结与最佳实践

推荐最佳实践：

案例：批量将 `.jpg` 文件改为 `.jpeg`