Python批量修改文件后缀实现方案与示例代码

需求背景与解决思路

部分移动端或轻量级阅读器对特定代码文件（如.js）支持不完善，读取后常出现无法退出或界面冻结的情况。为了解决兼容性限制，最直接的方法是将这些文件批量转换为通用的纯文本格式（如.txt）。手动逐页更改不仅耗时，还容易遗漏深层目录中的文件。利用Python内置的os模块，可以仅用几十行代码完成全路径递归扫描与自动重命名。

安全准备与前置条件

在执行批量覆盖或重命名操作前，务必先备份目标文件夹。一旦脚本将重要源码或配置文件误改后缀，可能导致依赖该文件的其他程序失效。
确保运行环境已安装Python 3。以下示例使用现代语法重构，彻底解决了原代码中硬编码的反斜杠路径拼接问题，并确保在Windows、macOS与Linux上均能稳定运行。

完整脚本与操作流程

第1步：编写重命名核心逻辑

目的：获取用户指定的目标路径、原始后缀与目标后缀，并在内存中构建安全的映射关系。

# -*- coding:utf-8 -*-
import os

def batch_rename():
    # 获取输入参数
    target_path = input("请输入要处理的文件夹路径: ").strip()
    if not os.path.isdir(target_path):
        print("错误：路径不存在或不是文件夹")
        return

    old_ext = input("请输入原始文件后缀(例如 .js): ").strip()
    new_ext = input("请输入目标文件后缀(例如 .txt): ").strip()

    processed_count = 0
    # 遍历目录树，topdown=True保证按顺序向下访问
    for dirpath, dirnames, filenames in os.walk(target_path):
        for filename in filenames:
            # 提取当前文件的扩展名
            _, current_ext = os.path.splitext(filename)
            
            # 忽略空字符串后缀，精确匹配（区分大小写）
            if current_ext.lower() == old_ext.lower() and current_ext != '':
                # 使用os.path.join安全拼接路径
                old_full_path = os.path.join(dirpath, filename)
                new_filename = filename.replace(current_ext, '') + new_ext
                new_full_path = os.path.join(dirpath, new_filename)

                try:
                    # 执行重命名
                    os.rename(old_full_path, new_full_path)
                    processed_count += 1
                    print(f"已重命名: {filename} -> {new_filename}")
                except Exception as e:
                    print(f"跳过失败文件 [{filename}]: {e}")

    print(f"全部完成！共成功转换 {processed_count} 个文件。")

if __name__ == '__main__':
    batch_rename()

第2步：运行脚本并核对入口参数

在终端或命令行中执行脚本：python rename_script.py。按提示依次输入参数：

• 目标路径：支持绝对路径或相对路径，切勿直接回车跳过。
• 原始后缀：必须包含点号，例如输入 .js。
• 目标后缀：同样需带点号，例如输入 .txt。

第3步：观察运行反馈与确认完成状态

脚本执行期间会在终端打印每条成功的重命名记录。当屏幕显示“全部完成！共成功转换 X 个文件。”时，即表示任务结束。此时返回文件管理器，打开对应目录即可看到所有指定后缀已被统一替换。若遇到权限不足或文件被占用导致的报错，终端会打印具体的异常信息，未受影响的文件不会受到影响。

常见问题排查与优化建议

路径分隔符兼容问题：早期写法常用"\"手动拼接路径，在不同操作系统下极易引发OSError。本示例全面改用os.path.join()，自动适配系统默认的分隔符。
大小写敏感性：部分系统（如macOS）不严格区分后缀大小写，脚本中加入了.lower()比对，确保.JS与.js均可被正确识别。
不可逆操作警告：批量修改后缀属于高风险操作。如果目标文件夹内存在同名但不同路径的文件，或意外将非目标格式文件（如.js.map）误判，可能会破坏项目结构。建议先在测试子文件夹中运行一次，确认统计数值符合预期后再处理生产数据。

以上就是批量修改文件后缀的详细实现方案，更多关于Python自动化办公与系统工具开发的资料请关注本站其它相关文章！