Python os.rename函数详解

1. 简介

在Python中，os模块提供了许多与操作系统交互的函数，包括文件系统操作、进程管理、环境变量等。其中，os.rename函数用于对文件或目录进行重命名操作。

os.rename(src, dst)函数接受两个参数，分别代表原始路径和目标路径。通过调用该函数，可以将原始路径的文件或目录重命名为目标路径指定的名称。

值得注意的是，os.rename函数只能用于移动文件或目录的名称，不能用于移动文件或目录的位置。如果要移动文件或目录的位置，可以使用shutil.move函数。

下面，我们将对os.rename函数进行详细的介绍和示例演示。

2. 使用示例

2.1 重命名文件

首先，我们介绍如何使用os.rename函数来重命名文件。

示例代码：

import os

# 当前工作目录下的文件名
src_file = "old_name.txt"
dst_file = "new_name.txt"

# 文件重命名
os.rename(src_file, dst_file)

示例说明：

在上述示例代码中，首先导入了os模块。然后，定义了要重命名的文件名，原始文件名为old_name.txt，目标文件名为new_name.txt。

最后，通过调用os.rename函数，将原始文件名重命名为目标文件名。

示例运行结果：

执行上述示例代码后，如果当前工作目录下存在名为old_name.txt的文件，则该文件将被重命名为new_name.txt。如果文件不存在，则会抛出FileNotFoundError异常。

2.2 重命名目录

除了文件，os.rename函数也可以用于重命名目录。

示例代码：

import os

# 当前工作目录下的目录名
src_dir = "old_dir"
dst_dir = "new_dir"

# 目录重命名
os.rename(src_dir, dst_dir)

示例说明：

在上述示例代码中，依然导入了os模块。接着，定义了要重命名的目录名，原始目录名为old_dir，目标目录名为new_dir。

最后，通过调用os.rename函数，将原始目录名重命名为目标目录名。

示例运行结果：

执行上述示例代码后，如果当前工作目录中存在名为old_dir的目录，则该目录将被重命名为new_dir。如果目录不存在，则会抛出FileNotFoundError异常。

2.3 错误处理

在使用os.rename函数进行重命名操作时，可能会遇到一些错误。例如，如果目标路径已存在同名的文件或目录，将会抛出FileExistsError异常。

为了处理这些错误，我们可以使用try-except语句进行异常捕获。下面是一个对错误进行处理的示例代码。

示例代码：

import os

src = "old_name.txt"
dst = "new_name.txt"

try:
    os.rename(src, dst)
except FileExistsError:
    print(f"文件 {dst} 已存在，请更换新的目标文件名。")

示例说明：

在上述示例代码中，我们使用try-except语句捕获了FileExistsError异常。如果目标路径已存在同名的文件或目录，则会进入except代码块。

在except代码块中，我们打印了一条错误消息，提示用户更换新的目标文件名。

示例运行结果：

如果当前工作目录下已经存在名为new_name.txt的文件，则执行示例代码后会输出以下错误提示消息：

文件 new_name.txt 已存在，请更换新的目标文件名。

2.4 批量重命名文件

有时候，我们需要对某个文件夹下的多个文件进行批量重命名操作。下面是一个批量重命名文件的示例代码。

示例代码：

import os

# 获取当前工作目录
folder = os.getcwd()

# 遍历文件夹下的所有文件
for file in os.listdir(folder):
    if file.endswith(".txt"):
        # 构造目标文件名
        dst = file.replace("old", "new")

        # 文件重命名
        os.rename(file, dst)