Python os.rename() 方法（超详细）

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

在日常开发中，我们经常会遇到需要批量处理文件名的场景。比如，整理项目中的图片文件、清理日志文件命名规范，或者为自动化脚本重命名输出结果。这时候，Python os.rename() 方法就成了一个非常实用的工具。它属于 os 模块，专门用来修改文件或目录的名称。虽然名字简单，但背后的功能却非常强大，掌握它能让你的脚本自动化能力大幅提升。

这篇文章将带你从零开始，系统学习 os.rename() 方法的使用方式，包括基本语法、常见用法、错误处理、实战案例，以及一些容易踩坑的地方。无论你是初学者还是有一定经验的开发者，都能从中获得实用价值。

基本语法与参数说明

os.rename() 方法的定义非常简洁：

os.rename(src, dst)

src：源文件或目录的路径（当前名称）
dst：目标路径（新名称）

⚠️ 注意：src 和 dst 都是字符串类型，必须是合法的文件路径。

这个方法的逻辑就像是“搬家”——把一个文件从一个名字搬到另一个名字下。它不复制文件，而是直接更改文件的元数据（即文件名），所以效率很高，不会占用额外磁盘空间。

举个生活化的比喻

你可以把 os.rename() 想象成给一本书重新贴标签。原来的书名是《Python入门》，你不想让它叫这个名字了，就把它原来的标签撕掉，贴上新标签《Python从零开始》。整本书的内容没变，只是标签变了。os.rename() 就是这样，只改名字，不改内容。

实际案例：基础重命名操作

下面通过几个真实场景，演示如何使用 os.rename()。

案例 1：重命名单个文件

假设你有一个名为 old_report.txt 的文件，你想把它改成 new_report.txt。

import os

old_name = "old_report.txt"
new_name = "new_report.txt"

os.rename(old_name, new_name)

print("文件已成功重命名为：", new_name)

📌 中文注释说明：

第 3 行定义了旧文件名，也就是当前的文件名。
第 6 行定义了新文件名。
第 9 行调用 os.rename()，将旧名改为新名。
第 12 行输出提示，确认操作成功。

✅ 提示：如果文件不存在，会抛出 FileNotFoundError；如果目标路径已存在，会抛出 FileExistsError。

案例 2：重命名目录

os.rename() 不仅能用于文件，也能用于目录。比如你想把一个叫 temp_folder 的文件夹重命名为 backup_data。

import os

old_dir = "temp_folder"
new_dir = "backup_data"

os.rename(old_dir, new_dir)

print("目录已成功重命名为：", new_dir)

📌 注释说明：

与文件操作完全一致，os.rename() 会自动识别是文件还是目录。
路径必须是有效的，且目标路径不能已存在同名项。

常见错误与异常处理

在使用 os.rename() 时，最常见的问题就是各种异常。我们来逐一分析并提供解决方案。

错误 1：文件不存在

import os

try:
    os.rename("nonexistent.txt", "new.txt")
except FileNotFoundError:
    print("错误：源文件不存在，请检查路径是否正确。")

📌 解释：如果 src 路径指向的文件或目录不存在，Python 会抛出 FileNotFoundError。这是最常见的错误之一。

错误 2：目标路径已存在

import os

try:
    os.rename("file1.txt", "file2.txt")
except FileExistsError:
    print("错误：目标文件已存在，无法重命名。请先删除或修改目标名。")

📌 说明：如果 dst 路径已经有一个同名文件或目录，os.rename() 会直接报错，不会覆盖。这是为了防止误操作。

错误 3：权限不足

在某些系统（如 Linux 或 macOS）中，如果你没有对目标路径的写权限，也会触发异常。

import os

try:
    os.rename("/root/protected.txt", "/root/new.txt")
except PermissionError:
    print("错误：没有权限修改该路径下的文件，请检查用户权限。")

📌 建议：开发时尽量使用相对路径，避免写绝对路径，尤其是在跨平台环境中。

批量重命名：自动化处理多个文件

在实际项目中，我们往往需要批量处理文件。比如，把项目中所有以 temp_ 开头的文件重命名为 final_。

案例：批量重命名以特定前缀开头的文件

import os

files = os.listdir(".")

for filename in files:
    # 检查是否以 'temp_' 开头
    if filename.startswith("temp_"):
        # 构造新文件名
        new_name = "final_" + filename[5:]  # 去掉前5个字符 'temp_'
        
        # 执行重命名
        os.rename(filename, new_name)
        print(f"已重命名：{filename} → {new_name}")

📌 注释说明：

os.listdir(".") 获取当前目录下所有文件和目录。
startswith("temp_") 判断文件名是否以 temp_ 开头。
filename[5:] 是字符串切片，去掉前 5 个字符，保留后续部分。
os.rename() 执行重命名操作。
打印每一步操作结果，方便调试。

✅ 小技巧：在批量操作前，建议先打印 print(filename) 看看哪些文件会被影响，避免误操作。

跨平台注意事项与路径处理

os.rename() 能在 Windows、Linux 和 macOS 上运行，但路径格式略有差异。

Windows 与 Unix 系统的路径分隔符不同

Windows 使用反斜杠 \，如：C:\Users\name\file.txt
Unix 系统（Linux/macOS）使用正斜杠 /，如：/home/user/file.txt

Python 的 os 模块会自动处理这些差异，但你仍然要注意：

使用 os.path.join() 拼接路径，而不是手动拼接字符串。

import os

src = os.path.join("data", "old_file.txt")
dst = os.path.join("data", "new_file.txt")

os.rename(src, dst)

📌 为什么这么做？

os.path.join() 会根据当前操作系统自动选择正确的分隔符。
避免手动拼接导致的路径错误（如 Windows 上出现 data\old_file.txt 但实际需要 /）。

实战场景：日志文件自动归档命名

想象一个日志系统，每天生成一个日志文件，命名为 app.log。为了避免覆盖，我们希望每天把旧日志重命名为 app_2024-04-05.log。

import os
from datetime import datetime

today = datetime.now().strftime("%Y-%m-%d")

old_log = "app.log"
new_log = f"app_{today}.log"

if os.path.exists(old_log):
    try:
        os.rename(old_log, new_log)
        print(f"日志已归档：{old_log} → {new_log}")
    except Exception as e:
        print(f"归档失败：{e}")
else:
    print("未找到日志文件，无需归档。")

📌 注释说明：

datetime.now().strftime("%Y-%m-%d") 获取当前日期。
f"app_{today}.log" 使用 f-string 构造新文件名。
os.path.exists() 检查文件是否存在，避免报错。
使用 try-except 捕获可能的异常。

这个例子非常适合用于定时任务（如用 cron 或 schedule 模块），实现自动日志归档。

总结与建议

Python os.rename() 方法虽然简单，但功能强大，是文件系统操作中不可或缺的一环。通过本文的学习，你应该掌握了：

方法的基本语法和使用方式
常见错误的处理策略
批量重命名的实战技巧
跨平台路径处理的最佳实践
与时间、条件结合的自动化场景

💡 最后提醒：在执行重命名操作前，务必先确认文件是否存在、目标路径是否可用。建议在正式运行前，先用 print() 打印出操作内容，进行“预演”。

在实际项目中，os.rename() 与 os.listdir()、os.path.exists()、os.path.join() 等方法配合使用，能构建出非常高效的文件管理脚本。掌握它，你就离自动化开发又近了一步。

无论你是写脚本整理文件，还是构建自动化部署流程，Python os.rename() 方法都值得你熟练掌握。希望这篇文章能成为你编程路上的实用参考。