python如何修改文件名

Python修改文件名的方法有多种，主要有以下几种：使用os模块、使用shutil模块、使用pathlib模块。这三种方法各有优劣，其中os模块是最基础也是最常用的方法。接下来，我们详细介绍如何使用os模块来修改文件名。

一、os模块修改文件名

os模块是Python标准库的一部分，提供了非常丰富的方法来处理文件和目录。使用os模块修改文件名通常通过os.rename()函数来实现。

1. 基本使用方法

os.rename()函数接受两个参数，第一个参数是当前的文件路径（包括文件名），第二个参数是新的文件路径（包括新的文件名）。以下是一个简单的例子：

import os
当前文件路径
old_name = 'path/to/your/file.txt'
新的文件路径
new_name = 'path/to/your/new_file.txt'
修改文件名
os.rename(old_name, new_name)

这种方法适用于简单的文件重命名操作，但如果需要批量修改文件名或进行更复杂的操作，还需要结合其他方法。

2. 批量修改文件名

如果需要批量修改文件名，比如在一个目录下所有文件名增加一个前缀，可以使用os.listdir()函数获取目录下的所有文件，然后逐个修改文件名。

import os
目标目录
target_directory = 'path/to/your/directory'
获取目标目录下的所有文件
files = os.listdir(target_directory)
批量修改文件名
for file_name in files:
    old_name = os.path.join(target_directory, file_name)
    new_name = os.path.join(target_directory, 'prefix_' + file_name)
    os.rename(old_name, new_name)

二、shutil模块修改文件名

shutil模块是Python的高级文件操作模块，提供了更多的功能，包括复制、移动、删除文件等。虽然shutil模块没有专门的重命名函数，但可以通过shutil.move()函数实现文件重命名。

import shutil
当前文件路径
old_name = 'path/to/your/file.txt'
新的文件路径
new_name = 'path/to/your/new_file.txt'
修改文件名
shutil.move(old_name, new_name)

shutil.move()函数不仅可以移动文件，还可以重命名文件。它的功能比os.rename()更强大，但在简单的重命名操作中，os.rename()已经足够。

三、pathlib模块修改文件名

pathlib模块是Python 3.4引入的一个模块，提供了面向对象的方法来处理文件和目录路径。使用pathlib模块修改文件名非常直观，代码可读性也很高。

from pathlib import Path
当前文件路径
old_name = Path('path/to/your/file.txt')
新的文件路径
new_name = old_name.with_name('new_file.txt')
修改文件名
old_name.rename(new_name)

pathlib模块的优势在于它的面向对象设计，使得路径操作更加直观和简洁。此外，pathlib模块还提供了许多便捷的方法来处理路径操作，比如获取文件扩展名、获取父目录等。

四、综合示例

为了更好地理解上述方法，我们可以结合实际场景，编写一个综合示例来批量修改文件名。这是一个将某个目录下所有文件名增加一个后缀的示例。

import os
from pathlib import Path
def rename_files_in_directory(directory, suffix):
    # 使用os模块获取目录下的所有文件
    files = os.listdir(directory)
    for file_name in files:
        old_file = Path(directory) / file_name
        new_file = old_file.with_name(old_file.stem + suffix + old_file.suffix)
        # 使用os模块修改文件名
        os.rename(old_file, new_file)
目标目录
target_directory = 'path/to/your/directory'
要增加的后缀
suffix = '_suffix'
批量修改文件名
rename_files_in_directory(target_directory, suffix)

在这个示例中，我们结合了os模块和pathlib模块的优势，编写了一个批量修改文件名的函数。这个函数可以很方便地应用于实际项目中，根据需要进行调整。

五、注意事项

在使用上述方法时，有几点需要注意：

文件路径：确保提供的文件路径是正确的，包括目录路径和文件名。
权限问题：确保脚本有足够的权限来修改文件名，否则可能会引发权限错误。
文件是否存在：在修改文件名之前，可以使用os.path.exists()函数检查文件是否存在。
文件名冲突：避免新的文件名与已有文件名冲突，否则可能会导致文件被覆盖或操作失败。

六、更多应用场景

除了简单的文件重命名操作，上述方法还可以应用于更多复杂的场景，比如：

1. 根据文件内容重命名

可以根据文件的内容来重命名文件，比如根据文件的第一行内容作为文件名。

import os
def rename_files_by_content(directory):
    files = os.listdir(directory)
    for file_name in files:
        file_path = os.path.join(directory, file_name)
        with open(file_path, 'r') as file:
            first_line = file.readline().strip()
        new_file_path = os.path.join(directory, first_line + '.txt')
        os.rename(file_path, new_file_path)
目标目录
target_directory = 'path/to/your/directory'
根据文件内容批量修改文件名
rename_files_by_content(target_directory)

2. 修改文件扩展名

可以批量修改文件的扩展名，比如将目录下所有.txt文件改为.md文件。

import os
def change_file_extension(directory, old_ext, new_ext):
    files = os.listdir(directory)
    for file_name in files:
        if file_name.endswith(old_ext):
            old_file = os.path.join(directory, file_name)
            new_file = os.path.join(directory, file_name.replace(old_ext, new_ext))
            os.rename(old_file, new_file)
目标目录
target_directory = 'path/to/your/directory'
批量修改文件扩展名
change_file_extension(target_directory, '.txt', '.md')