如何基于正则批量重命名文件并同步替换文件内对应旧文件名？

思路说明 #

你提到的先建立新旧文件名对照表、再批量处理的思路是最优方案，能够避免边重命名边替换导致的映射混乱、文件名冲突等问题，完全可以落地。

实现步骤 #

• 第一步：预生成全局新旧文件名映射表，全程基于原始文件名计算新名称，避免中间操作干扰映射结果，同时提前校验是否存在新文件名冲突，防止文件覆盖。
• 第二步：一次性完成所有文件的重命名操作，不要穿插内容修改，避免读写混乱。
• 第三步：批量替换所有文件内的旧文件名引用，这里可以通过正则预编译优化效率，避免重复遍历文件。

优化技巧 #

• 避免逐映射遍历文件：如果逐个拿旧文件名去所有文件里搜索替换，1000个文件就要遍历1000次文件内容，效率极低。可以把所有旧文件名拼成单个正则表达式，每个文件仅读取一次即可完成所有替换，性能提升10倍以上。
• 加匹配边界避免误替换：XML文件的文件名引用一般包裹在属性引号内，可以给正则加前后断言，仅匹配被双引号/单引号包裹的文件名，避免误替换文件内容里和文件名重名的其他文本。
• 提前做冲突检测：规则可能存在隐性冲突，比如原有文件a123和123，按规则前者会改成z123，后者也会改成z123，预生成映射的时候就可以检测出这类冲突，提前调整规则避免文件覆盖。

参考实现代码（Python） #

import os
import re

# 配置项
TARGET_DIR = "./你的目标文件夹路径"
# 仅处理指定后缀的文件，空字符串则处理所有文件
FILTER_SUFFIX = ".xml"
# 文件编码，根据实际情况调整为gbk等
FILE_ENCODING = "utf-8"

def main():
    # 1. 生成新旧文件名映射
    name_map = {}
    for filename in os.listdir(TARGET_DIR):
        file_path = os.path.join(TARGET_DIR, filename)
        # 跳过文件夹
        if not os.path.isfile(file_path):
            continue
        # 按后缀过滤
        if FILTER_SUFFIX and not filename.endswith(FILTER_SUFFIX):
            continue
        # 计算新文件名
        if filename.startswith("a"):
            new_filename = "z" + filename[1:]
        else:
            new_filename = "z" + filename
        # 冲突检测
        if new_filename in name_map.values():
            raise ValueError(f"文件名冲突：新名称 {new_filename} 对应多个旧文件，请调整规则")
        name_map[filename] = new_filename

    # 2. 批量重命名文件
    for old_name, new_name in name_map.items():
        old_path = os.path.join(TARGET_DIR, old_name)
        new_path = os.path.join(TARGET_DIR, new_name)
        os.rename(old_path, new_path)

    # 3. 批量替换文件内容中的旧文件名
    # 预编译正则，仅匹配双引号包裹的文件名，避免误替换
    pattern = re.compile(
        rf'(?<=")({"|".join(re.escape(old) for old in name_map.keys())})(?=")'
    )
    for new_name in name_map.values():
        file_path = os.path.join(TARGET_DIR, new_name)
        # 读取文件内容
        with open(file_path, "r", encoding=FILE_ENCODING) as f:
            content = f.read()
        # 一次性替换所有匹配项
        new_content = pattern.sub(lambda match: name_map[match.group(0)], content)
        # 写回文件
        with open(file_path, "w", encoding=FILE_ENCODING) as f:
            f.write(new_content)

if __name__ == "__main__":
    # 操作前务必备份原文件夹
    main()

注意事项 #

• 操作前必须完整备份目标文件夹，避免规则错误导致文件损坏或丢失
• 如果需要处理子目录下的文件，将os.listdir替换为os.walk递归遍历即可
• 如果文件名包含特殊正则字符（比如.、*等），代码中的re.escape已经做了转义处理，不需要额外调整

内容的提问来源于stack exchange，提问作者jennab