使用Python脚本批量遍历文件夹修改文件后缀与文件名

今天早睡
今天早睡
发布时间:2026-10-11| 5人浏览过
原创

本文介绍如何使用Python脚本批量修改指定文件夹及其子目录下的文件后缀名和文件名。通过递归遍历目录,脚本支持批量重命名文件前缀、修改文件扩展名或同时执行两项操作。文章提供了完整的Python代码示例、命令行参数说明及执行步骤,帮助用户高效处理大量文件的命名规范问题。

Python批量修改文件后缀与文件名脚本

在处理大量文件时,手动修改文件后缀名或文件名往往效率低下。通过编写Python脚本,可以实现对指定文件夹及其所有子目录的递归遍历,批量修改文件的前缀或扩展名。这种方法不仅节省时间,还能确保命名的一致性。

脚本功能概述

该Python脚本主要提供以下三种批量处理功能:

  • 修改目录和文件名前缀:将指定目录及子目录中,文件名包含特定字符串的部分替换为新的字符串。
  • 修改文件扩展名(后缀):将指定目录及子目录中,文件扩展名为特定值的文件,统一修改为新的扩展名。
  • 同时修改前缀和后缀:结合上述两种操作,一次性完成文件名前缀和扩展名的批量替换。

使用方法与参数说明

脚本通过命令行参数接收操作指令。基本调用格式为:python Modifer.py [目录路径] [选项] [参数1] [参数2]。

具体参数说明如下:

  • [目录路径]:指定需要处理的文件夹路径。路径中不应包含空格,否则可能导致脚本无法正确识别。
  • [选项]:指定操作类型,可选值包括:
    • -fd:仅修改目录和文件名前缀。
    • -fp:仅修改文件扩展名(后缀)。
    • -all:同时修改目录/文件名前缀和文件扩展名。
  • [参数1]:需要被替换的原始字符串(前缀或后缀)。
  • [参数2]:替换后的新字符串(前缀或后缀)。

例如,要将 ./ 目录下的所有 java 后缀文件修改为 xml 后缀,可执行命令:python Modifer.py ./ -fp java xml。

完整代码实现

以下是实现上述功能的Python脚本代码。该脚本使用 os 模块进行目录遍历和文件重命名,通过递归函数处理子目录。

# coding:utf-8
# Build by LandGrey 2016-05-27

import os
import sys

#批量修改路径与文件名
def Modifyprefix(Path,oldcontent,newcontent):
  all_file_list = os.listdir(Path)  #列出指定目录下的所有文件
  for file_name in all_file_list:
    currentdir =os.path.join(Path, file_name) #连接指定的路径和文件名or文件夹名字
    if os.path.isdir(currentdir):  #如果当前路径是文件夹,则跳过
      Modifyprefix(currentdir,oldcontent,newcontent)
    fname = os.path.splitext(file_name)[0] #分解出当前的文件路径名字
    ftype = os.path.splitext(file_name)[1] #分解出当前的文件扩展名
    if oldcontent in fname:
      fdcount[0]+=1
      replname =fname.replace(oldcontent,newcontent) #将原文件名中的'oldcontent'字符串内容全替换为'newcontent'字符串内容
      newname = os.path.join(Path,replname+ftype)  #文件路径与新的文件名字+原来的扩展名
      os.rename(currentdir,newname) #重命名

#批量修改文件扩展名(后缀)
def Modifypostfix(Path,oldftype,newftype):
  all_file_list = os.listdir(Path)     #列出指定目录下的所有文件
  for file_name in all_file_list:
    currentdir =os.path.join(Path,file_name)
    if os.path.isdir(currentdir):          #迭代
      Modifypostfix(currentdir,oldftype,newftype)
    fname = os.path.splitext(file_name)[0]
    ftype = os.path.splitext(file_name)[1]
    if oldftype in ftype[1:]: #找到需要修改的扩展名
      typecount[0]+=1
      ftype=ftype.replace(oldftype,newftype)
      newname = os.path.join(Path,fname+ftype) #文件路径与原来的文件名字+新的扩展名
      os.rename(currentdir,newname)        #重命名

def Useage():
  print unicode("\n[+] 用法: python Modifer.py [指定目录] [选项] [参数1] [参数2]","utf-8")
  print unicode("[+] 选项 [-fd] :批量修改目录和文件名        [参数1]: 需要替换的字符   [参数2]:替换字符串","utf-8")
  print unicode("[+] 选项 [-fp] :批量修改文件后缀名         [参数1]: 原后缀名      [参数2]:需要替换的后缀名","utf-8")
  print unicode("[+] 选项 [-all] :批量修改目录、文件名和文件后缀名  [参数1]: 需要替换的字符部分 [参数2]:替换字符串","utf-8")
  print unicode(r"[+] 用法示例:python Modifer.py D:\files -fp txt data","utf-8")

if __name__=="__main__":
  typecount=[0]
  fdcount=[0]
  if len(sys.argv)==2 and "-h" in sys.argv[1]:
    Useage()
    sys.exit()
  elif len(sys.argv) !=5:
    print unicode("\n[+] 参数错误 !\n","utf-8")
    print unicode("[+] 用 -h 或--help 参数查看Modifer.py用法","utf-8")
    sys.exit()
  elif os.path.isdir(sys.argv[1]) is False:
    print unicode("\n[+] 指定目录错误 ! 请检查输入路径是否正确,路径中不能有空格\n","utf-8")
    print unicode("[+] 用 -h 或--help 参数查看Modifer.py用法","utf-8")
    sys.exit()
  elif sys.argv[2]=="-fd":
    Modifyprefix(sys.argv[1],sys.argv[3],sys.argv[4])
    print unicode("\n[+] Modifer.py  Build by LandGrey","utf-8")
    print unicode("[+] 完成 !","utf-8")
    print unicode("[+] 共修改%s个目录和文件名"%fdcount[0],"utf-8")
  elif sys.argv[2]=="-fp":
    Modifypostfix(sys.argv[1],sys.argv[3],sys.argv[4])
    print unicode("\n[+] Modifer.py  Build by LandGrey","utf-8")
    print unicode("[+] 完成 !","utf-8")
    print unicode("[+] 共修改%s个后缀名"%typecount[0],"utf-8")
  elif sys.argv[2]=="-all":
    Modifypostfix(sys.argv[1],sys.argv[3],sys.argv[4])
    Modifyprefix(sys.argv[1],sys.argv[3],sys.argv[4])
    print unicode("\n[+] Modifer.py  Build by LandGrey","utf-8")
    print unicode("[+] 完成 !","utf-8")
    print unicode("[+] 共修改%s个目录名、文件名和后缀名"%(typecount[0]+fdcount[0]),"utf-8")
  else:
    print unicode("\n[+] 选项错误 !\n","utf-8")
    print unicode("[+] 用 -h 或--help 参数查看Modifer.py用法","utf-8")
    sys.exit()

注意事项

在执行批量修改操作前,请务必注意以下几点:

  • 备份数据:批量重命名操作不可逆,建议在操作前对目标文件夹进行完整备份,以防误操作导致文件丢失或损坏。
  • 路径检查:脚本要求指定目录必须存在且为有效文件夹。此外,路径中不应包含空格,否则可能导致脚本无法正确解析路径。
  • 权限问题:确保运行脚本的用户对目标文件夹具有读写权限,否则 os.rename 操作可能会失败。

通过上述脚本,用户可以灵活地批量处理文件命名问题,提高文件管理效率。

以上就是Python实现遍历文件夹修改文件后缀的详细内容,更多关于Python批量修改文件后缀的资料请关注本站其它相关文章!

相关标签:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。