在Python中，文件重命名的核心方法是使用os模块的rename()函数、shutil模块的move()函数、pathlib模块的rename()方法。 其中，最常用的方式是使用os模块的rename()函数，它简单易用且功能强大。下面将详细介绍这三种方法，并提供一些实际使用中的建议和注意事项。
一、os模块重命名方法
os模块是Python的标准库之一，提供了与操作系统进行交互的多种方法。os.rename()函数是用于重命名文件或目录的常用方法。
使用os.rename()重命名文件
要使用os.rename()函数来重命名文件，首先需要导入os模块。然后，调用os.rename()函数，传入两个参数：旧文件名和新文件名。以下是一个简单的示例：
import os
旧文件名
old_name = 'old_file.txt'
新文件名
new_name = 'new_file.txt'
重命名文件
os.rename(old_name, new_name)
print(f'文件 {old_name} 已成功重命名为 {new_name}')
在上述代码中，首先导入了os模块，然后定义了旧文件名和新文件名，并使用os.rename()函数将旧文件名重命名为新文件名。最后，打印出重命名成功的信息。
注意事项：
- 确保文件存在：在重命名文件之前，确保旧文件名对应的文件存在。如果文件不存在，os.rename()函数会抛出FileNotFoundError异常。
- 文件权限：确保对文件具有读写权限。如果没有适当的权限，os.rename()函数会抛出PermissionError异常。
- 目标文件名：如果目标文件名已经存在，os.rename()函数会覆盖目标文件。因此，在重命名之前，建议检查目标文件名是否已存在。
示例：批量重命名文件
在实际应用中，可能需要批量重命名文件。例如，将一个目录中的所有文件按照某种规则重命名。以下是一个示例，展示如何批量重命名一个目录中的所有文件：
import os
要重命名的目录
directory = 'example_directory'
列出目录中的所有文件
files = os.listdir(directory)
遍历文件列表，逐个重命名
for i, file_name in enumerate(files):
old_path = os.path.join(directory, file_name)
new_path = os.path.join(directory, f'file_{i}.txt')
# 重命名文件
os.rename(old_path, new_path)
print(f'文件 {old_path} 已成功重命名为 {new_path}')
在上述代码中，首先列出指定目录中的所有文件，然后遍历文件列表，使用os.rename()函数逐个重命名文件。
二、shutil模块重命名方法
shutil模块是Python的标准库之一，提供了一些高级的文件操作功能，包括复制、移动和删除文件。虽然shutil模块没有专门的重命名函数，但可以使用shutil.move()函数来实现文件重命名。
使用shutil.move()重命名文件
shutil.move()函数可以用来移动文件或目录，同时也可以用来重命名文件。以下是一个简单的示例：
import shutil
旧文件名
old_name = 'old_file.txt'
新文件名
new_name = 'new_file.txt'
重命名文件
shutil.move(old_name, new_name)
print(f'文件 {old_name} 已成功重命名为 {new_name}')
在上述代码中，首先导入了shutil模块，然后定义了旧文件名和新文件名，并使用shutil.move()函数将旧文件名重命名为新文件名。最后，打印出重命名成功的信息。
注意事项：
- 确保文件存在：与os.rename()函数类似，在重命名文件之前，确保旧文件名对应的文件存在。如果文件不存在，shutil.move()函数会抛出FileNotFoundError异常。
- 文件权限：确保对文件具有读写权限。如果没有适当的权限，shutil.move()函数会抛出PermissionError异常。
- 目标文件名：如果目标文件名已经存在，shutil.move()函数会覆盖目标文件。因此，在重命名之前，建议检查目标文件名是否已存在。
三、pathlib模块重命名方法
pathlib模块是Python 3.4引入的一个面向对象的文件系统路径库，提供了更直观和简洁的文件路径操作方式。Path对象的rename()方法可以用来重命名文件。
使用Path对象的rename()方法重命名文件
要使用pathlib模块重命名文件，首先需要导入pathlib.Path类。然后，创建Path对象，并调用rename()方法。以下是一个简单的示例：
from pathlib import Path
旧文件名
old_name = Path('old_file.txt')
新文件名
new_name = Path('new_file.txt')
重命名文件
old_name.rename(new_name)
print(f'文件 {old_name} 已成功重命名为 {new_name}')
在上述代码中，首先导入了pathlib.Path类，然后定义了旧文件名和新文件名，并使用Path对象的rename()方法将旧文件名重命名为新文件名。最后，打印出重命名成功的信息。
注意事项：
- 确保文件存在：与os.rename()函数和shutil.move()函数类似，在重命名文件之前，确保旧文件名对应的文件存在。如果文件不存在，rename()方法会抛出FileNotFoundError异常。
- 文件权限：确保对文件具有读写权限。如果没有适当的权限，rename()方法会抛出PermissionError异常。
- 目标文件名：如果目标文件名已经存在，rename()方法会覆盖目标文件。因此，在重命名之前，建议检查目标文件名是否已存在。
示例：使用pathlib模块批量重命名文件
与os模块类似，pathlib模块也可以用来批量重命名文件。以下是一个示例，展示如何使用pathlib模块批量重命名一个目录中的所有文件：
from pathlib import Path
要重命名的目录
directory = Path('example_directory')
列出目录中的所有文件
files = list(directory.iterdir())
遍历文件列表，逐个重命名
for i, file_path in enumerate(files):
new_path = directory / f'file_{i}.txt'
# 重命名文件
file_path.rename(new_path)
print(f'文件 {file_path} 已成功重命名为 {new_path}')
在上述代码中，首先列出指定目录中的所有文件，然后遍历文件列表，使用Path对象的rename()方法逐个重命名文件。
总结
在Python中，重命名文件的方法有多种，包括使用os模块的rename()函数、shutil模块的move()函数和pathlib模块的rename()方法。每种方法都有其优缺点和适用场景，选择合适的方法可以提高代码的可读性和可维护性。
关键点总结：
- os.rename()：简单易用，适用于大多数文件重命名场景。
- shutil.move()：功能更强大，适用于需要移动文件或目录的场景。
- pathlib.Path.rename()：面向对象的方式，更直观和简洁，适用于现代Python代码。
在实际应用中，可以根据具体需求选择合适的方法。同时，注意在重命名文件之前，确保文件存在并具有适当的权限，以避免异常的发生。
相关问答FAQs：
如何在Python中使用os模块重命名文件？
使用os模块可以方便地进行文件重命名。首先，您需要导入os模块。接着，使用os.rename()函数传入旧文件名和新文件名作为参数。例如：
import os
os.rename('旧文件名.txt', '新文件名.txt')
这将会将指定的旧文件重命名为新文件名。
在Python中重命名文件时，如何处理文件路径问题？
确保在重命名文件时，提供正确的文件路径。如果文件不在当前工作目录中，您需要提供完整的路径。例如：
os.rename('/path/to/old_file.txt', '/path/to/new_file.txt')
使用绝对路径可以避免因当前工作目录不正确而导致的错误。
重命名文件时，如何避免覆盖已存在的文件？
在重命名文件之前，可以使用os.path.exists()函数检查新文件名是否已存在。这样可以有效防止意外覆盖文件。以下是一个示例：
new_name = '新文件名.txt'
if not os.path.exists(new_name):
os.rename('旧文件名.txt', new_name)
else:
print("新文件名已存在，请选择其他名称。")
通过这种方式，您可以确保重命名操作的安全性。
