python如何批量替换文件名

Python 批量替换文件名的方法有多种，其中常见的方式包括使用 os 模块或 shutil 模块。通过os模块遍历文件、使用字符串操作替换文件名、使用os.rename函数重命名文件。接下来我们将详细讲解其中一种方法。

使用os模块遍历文件并批量替换文件名

import os
def batch_rename_files(directory, old_str, new_str):
    for filename in os.listdir(directory):
        if old_str in filename:
            new_name = filename.replace(old_str, new_str)
            os.rename(os.path.join(directory, filename), os.path.join(directory, new_name))
            print(f'Renamed: {filename} to {new_name}')
directory = '/path/to/your/directory'
old_str = 'old_text'
new_str = 'new_text'
batch_rename_files(directory, old_str, new_str)

一、OS模块介绍

OS模块是Python标准库中的一个模块，提供了与操作系统进行交互的功能。使用os模块，我们可以轻松地实现文件和目录的遍历、文件名的替换和重命名等操作。为了更好地理解批量替换文件名的过程，我们需要先了解几个os模块中的关键函数和方法。

1. os.listdir()函数

os.listdir()函数用于获取指定目录中的所有文件和目录的名称。该函数返回一个包含目录中文件和目录名称的列表。

import os
directory = '/path/to/your/directory'
files = os.listdir(directory)
print(files)

2. os.path.join()函数

os.path.join()函数用于将多个路径组合在一起，形成一个完整的路径。该函数接受多个路径作为参数，并返回一个完整的路径字符串。

import os
path = os.path.join('/path/to', 'your', 'directory')
print(path)

3. os.rename()函数

os.rename()函数用于重命名文件或目录。该函数接受两个参数：旧名称和新名称。使用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)

二、字符串操作

在进行批量替换文件名的过程中，我们需要对文件名进行字符串操作。Python提供了丰富的字符串操作函数，可以方便地实现字符串的查找和替换等操作。

1. str.replace()方法

str.replace()方法用于将字符串中的指定子字符串替换为新的子字符串。该方法接受两个参数：旧子字符串和新子字符串，并返回一个替换后的新字符串。

old_str = 'old_text'
new_str = 'new_text'
filename = 'example_old_text.txt'
new_filename = filename.replace(old_str, new_str)
print(new_filename)

三、批量替换文件名的实现

下面是一个完整的示例代码，通过os模块和字符串操作，实现批量替换文件名的功能。

import os
def batch_rename_files(directory, old_str, new_str):
    for filename in os.listdir(directory):
        if old_str in filename:
            new_name = filename.replace(old_str, new_str)
            os.rename(os.path.join(directory, filename), os.path.join(directory, new_name))
            print(f'Renamed: {filename} to {new_name}')
directory = '/path/to/your/directory'
old_str = 'old_text'
new_str = 'new_text'
batch_rename_files(directory, old_str, new_str)

1. 遍历目录中的所有文件

首先，我们使用os.listdir()函数获取指定目录中的所有文件和目录名称。然后，使用for循环遍历这些文件和目录。

2. 查找和替换文件名中的指定子字符串

在遍历文件的过程中，我们使用if语句检查文件名中是否包含指定的旧子字符串。如果包含，我们使用str.replace()方法将旧子字符串替换为新子字符串，生成新的文件名。

3. 重命名文件

最后，我们使用os.rename()函数将旧文件名重命名为新的文件名。重命名成功后，输出重命名的文件名信息。

四、注意事项

在进行批量替换文件名的过程中，需要注意以下几点：

确保目录路径正确：在使用os.listdir()函数之前，确保指定的目录路径正确。如果路径不正确，程序将无法获取目录中的文件和目录名称。
确保旧子字符串和新子字符串正确：在使用str.replace()方法之前，确保指定的旧子字符串和新子字符串正确。如果旧子字符串不正确，程序将无法找到需要替换的子字符串。
确保文件名不冲突：在重命名文件之前，确保新的文件名不会与目录中的其他文件名冲突。如果发生文件名冲突，os.rename()函数将抛出异常，导致程序终止。
备份重要文件：在进行批量替换文件名之前，建议备份重要文件。这样可以避免在操作过程中意外丢失或损坏文件。

五、扩展功能

在实际应用中，我们可能需要对批量替换文件名的功能进行扩展，以满足特定需求。下面是一些常见的扩展功能：

1. 递归遍历子目录

如果目录中包含子目录，我们可以使用递归遍历子目录中的文件，进行批量替换文件名。可以使用os.path.isdir()函数检查目录项是否为子目录，如果是子目录，递归调用批量替换文件名的函数。

import os
def batch_rename_files(directory, old_str, new_str):
    for filename in os.listdir(directory):
        file_path = os.path.join(directory, filename)
        if os.path.isdir(file_path):
            batch_rename_files(file_path, old_str, new_str)
        elif old_str in filename:
            new_name = filename.replace(old_str, new_str)
            os.rename(file_path, os.path.join(directory, new_name))
            print(f'Renamed: {filename} to {new_name}')
directory = '/path/to/your/directory'
old_str = 'old_text'
new_str = 'new_text'
batch_rename_files(directory, old_str, new_str)

2. 使用正则表达式替换文件名

有时，我们可能需要使用正则表达式进行复杂的字符串替换操作。可以使用re模块中的re.sub()函数实现正则表达式替换文件名的功能。

import os
import re
def batch_rename_files(directory, pattern, repl):
    for filename in os.listdir(directory):
        new_name = re.sub(pattern, repl, filename)
        if new_name != filename:
            os.rename(os.path.join(directory, filename), os.path.join(directory, new_name))
            print(f'Renamed: {filename} to {new_name}')
directory = '/path/to/your/directory'
pattern = r'old_\d+'
repl = 'new_'
batch_rename_files(directory, pattern, repl)

3. 处理文件名大小写

在某些情况下，我们可能需要忽略文件名的大小写，进行批量替换文件名。可以使用str.lower()或str.upper()方法将文件名转换为小写或大写，然后进行替换操作。

import os
def batch_rename_files(directory, old_str, new_str, ignore_case=True):
    for filename in os.listdir(directory):
        if ignore_case:
            if old_str.lower() in filename.lower():
                new_name = filename.lower().replace(old_str.lower(), new_str)
        else:
            if old_str in filename:
                new_name = filename.replace(old_str, new_str)
        if new_name != filename:
            os.rename(os.path.join(directory, filename), os.path.join(directory, new_name))
            print(f'Renamed: {filename} to {new_name}')
directory = '/path/to/your/directory'
old_str = 'OLD_TEXT'
new_str = 'new_text'
batch_rename_files(directory, old_str, new_str)