✅ 核心前言

✔️ 适用人群：Python零基础、办公自动化刚需、需要批量整理文件（照片/文档/视频/代码）的同学
✔️ 核心优势：纯Python内置库，无需安装任何第三方依赖、10分钟写完、代码极简+全注释、兼容Windows/Mac/Linux、一键运行
✔️ 实现功能：批量添加前缀/后缀、序号递增命名、批量替换文件名字符、批量删除指定字符、批量修改文件后缀，满足99%的文件重命名需求
✔️ 避坑指南：文件重命名【8大必踩坑+解决方案】，写完工具不会用/用错删文件？看完彻底规避所有风险！

💡 为什么这个工具超实用？

日常工作中我们总会遇到这些场景：相机导出的照片是DSC0001.jpg、下载的资料是无标题文档123.txt、批量保存的图片是杂乱无章的字符名…手动一个一个改文件名，费时费力还容易出错。
用Python写这个批量重命名工具，一次编写永久使用，几十上百个文件几秒就能批量改好，而且代码总共就几十行，零基础也能看懂、能修改、能运行！

一、前置准备（零基础必看，2分钟搞定）

✅ 1. 核心依赖：仅用Python【内置库】，零安装

本次实战只用到Python自带的两个库，不用执行pip install任何命令，新建.py文件直接写代码即可，完美适配所有Python版本（3.6及以上都支持）：

• os：Python核心系统库，用于获取文件列表、拼接文件路径、执行文件重命名，文件操作必备
• sys：可选，用于处理中文路径/系统兼容问题，一行代码解决中文乱码

✅ 2. 关键概念（新手必懂，避坑基础）

1. 目标文件夹路径：要批量重命名的文件所在文件夹，比如C:\用户\桌面\照片（Windows）、/Users/xxx/Desktop/文档（Mac）
2. 相对路径 & 绝对路径：
   • 相对路径：把.py文件直接放在要重命名的文件同目录下，路径写.即可，推荐新手用！不用记复杂路径，零错误。
   • 绝对路径：文件在电脑中的完整位置，比如Windows的C:\xx\xx，Mac的/xx/xx
3. 文件与文件夹区分：我们只重命名「文件」，不重命名「文件夹」，代码会自动过滤文件夹，避免误操作。

✅ 3. 运行方式（零基础操作）

1. 打开记事本/VSCode/PyCharm，复制下方源码，粘贴保存为批量重命名工具.py；
2. 将该py文件，放到【需要批量重命名的文件所在文件夹】中；
3. 双击运行该py文件，或者在终端执行python 批量重命名工具.py，一键生效！

二、版本一：基础万能版【最常用，10分钟写完，推荐首选】

✅ 实现功能

批量给文件夹内指定类型的所有文件，添加自定义前缀 +有序数字编号，是日常使用频率90%的功能。

例：把照片1.jpg、风景.png、视频.mp4→ 改成旅行_001.jpg、旅行_002.png、旅行_003.mp4
例：把笔记.txt、报告.docx、数据.xlsx→ 改成工作文档_001.txt、工作文档_002.docx

✅ 完整源码（全注释，零基础能看懂，直接复制用）

importos# ===================== 【可修改的配置项，按需改这5行即可，其余不用动】 =====================target_dir="."# 目标文件夹路径，. 代表当前py文件所在的文件夹，新手推荐不改prefix_name="旅行照片_"# 自定义文件名前缀，想改什么就写什么，比如"工作文档_"、"学习资料_"start_num=1# 起始编号，比如从1开始还是从100开始num_length=3# 编号位数，3代表001、002，2代表01、02，1代表1、2file_suffix=""# 指定文件后缀，留空=重命名【所有文件】，写".jpg"=只重命名jpg图片，写".txt"=只重命名txt文档# ===================== 【核心重命名逻辑，零基础勿改】 =====================defbatch_rename():# 1. 获取目标文件夹下的所有文件和文件夹file_list=os.listdir(target_dir)# 用于计数，实现有序编号count=start_num# 2. 遍历所有文件forfile_nameinfile_list:# 拼接文件的完整路径（当前文件夹+文件名）old_file_path=os.path.join(target_dir,file_name)# ✅ 核心避坑1：只处理【文件】，跳过【文件夹】，避免把文件夹也重命名了ifos.path.isdir(old_file_path):continue# ✅ 核心避坑2：只处理指定后缀的文件，留空则处理所有文件iffile_suffixandnotfile_name.endswith(file_suffix):continue# 3. 拆分文件名和后缀，例：风景.jpg → 文件名=风景，后缀=.jpgfile_name_only,file_ext=os.path.splitext(file_name)# 4. 拼接新文件名：前缀 + 补零编号 + 文件后缀new_file_name=f"{prefix_name}{count:0{num_length}d}{file_ext}"# 拼接新文件的完整路径new_file_path=os.path.join(target_dir,new_file_name)# 5. 执行重命名操作os.rename(old_file_path,new_file_path)print(f"重命名成功：{file_name}→{new_file_name}")# 编号自增count+=1# 运行程序if__name__=="__main__":batch_rename()print("✅ 所有文件批量重命名完成！")

✅ 如何修改配置？（举3个常用例子，照抄就行）

例子1：批量整理桌面的【所有图片】，前缀为「风景_」，编号001开始

prefix_name="风景_"start_num=1num_length=3file_suffix=".jpg"# 只改jpg图片，改png就写.png，改所有图片就写空

例子2：批量整理工作【所有文档】，前缀为「项目周报_」，编号从10开始，两位数字

prefix_name="项目周报_"start_num=10num_length=2# 编号显示10、11、12...file_suffix=""# 所有文档都改（txt/docx/xlsx/pdf）

例子3：批量整理视频，前缀为「教程_」，编号从1开始，一位数字

prefix_name="教程_"start_num=1num_length=1# 编号显示1、2、3...file_suffix=".mp4"

三、版本二：进阶增强版【满足所有重命名需求，万能源码】

✅ 新增3个高频实用功能（覆盖99%场景）

在基础版之上，新增日常最需要的3个功能，4合1工具，注释清晰，按需开启对应功能即可，不用写多个脚本：

1. 批量替换文件名中的指定字符（例：去掉文件名里的「广告_」、「新建」、空格）
2. 批量删除文件名中的指定字符（例：删除文件名里的特殊符号、数字）
3. 批量修改文件后缀名（例：把所有.png改成.jpg，.txt改成.md）
4. 保留基础版的「前缀+编号」功能

✅ 完整进阶源码（全注释，按需开启功能，推荐收藏）

importos# ===================== 【配置项：按需开启/修改，想实现什么功能就改这里】 =====================target_dir="."# 当前文件夹，新手不改file_suffix=""# 留空=所有文件，指定后缀如".jpg"# ===== 功能1：批量替换字符（开启：修改old_str和new_str；关闭：都留空） =====old_str="广告_"# 要替换的字符，比如空格写" "，特殊符号写"【】"new_str=""# 替换成什么，留空就是【删除】该字符# ===== 功能2：批量添加前缀+有序编号（开启：修改下面3行；关闭：prefix_name留空） =====prefix_name=""# 前缀，留空不添加start_num=1num_length=3# ===== 功能3：批量修改文件后缀（开启：修改new_ext；关闭：留空） =====new_ext=""# 新后缀，例：".jpg"、".md"，留空则保留原后缀# ===================== 核心重命名函数 =====================defbatch_rename_advanced():file_list=os.listdir(target_dir)count=start_numforfile_nameinfile_list:old_file_path=os.path.join(target_dir,file_name)# 跳过文件夹，只处理文件ifos.path.isdir(old_file_path):continue# 过滤指定后缀的文件iffile_suffixandnotfile_name.endswith(file_suffix):continue# 拆分文件名和后缀file_name_only,file_ext=os.path.splitext(file_name)# 步骤1：批量替换/删除字符ifold_str:file_name_only=file_name_only.replace(old_str,new_str)# 步骤2：批量修改文件后缀ifnew_ext:file_ext=new_ext# 步骤3：添加前缀+有序编号ifprefix_name:new_file_name=f"{prefix_name}{count:0{num_length}d}{file_ext}"count+=1else:new_file_name=f"{file_name_only}{file_ext}"new_file_path=os.path.join(target_dir,new_file_name)# 执行重命名os.rename(old_file_path,new_file_path)print(f"✅{file_name}→{new_file_name}")if__name__=="__main__":batch_rename_advanced()print("\n🎉 批量重命名全部完成！")

✅ 进阶功能使用案例（照抄即用）

✔️ 案例1：批量删除文件名中的「空格」和「【】」

old_str=" "# 先删空格new_str=""# 删完空格后，再改old_str为"【】"，再运行一次即可

✔️ 案例2：把所有.png图片批量改成.jpg格式

new_ext=".jpg"file_suffix=".png"

✔️ 案例3：把文件名里的「测试」替换成「最终版」+ 添加前缀「项目_」

old_str="测试"new_str="最终版"prefix_name="项目_"

四、重中之重：文件批量重命名【8大必踩坑 + 解决方案】✅ 避坑指南（99%的人都踩过，看完零错误）

这是本次实战的核心重点！文件重命名是「不可逆操作」，一旦改错/删错，文件可能找不回来，所有坑都是我踩过的血泪经验，看完这些，你的工具才是真正能用的安全工具，按优先级排序，从高频到低频，全部规避！

❌ 坑1：运行报错「找不到文件/路径不存在」（新手最高频，100%踩）

现象：执行代码后提示FileNotFoundError: [WinError 3] 系统找不到指定的路径
原因：

1. py文件和要重命名的文件不在同一个文件夹，但配置里写了target_dir = "."；
2. 手动写的绝对路径有问题（比如Windows路径里的\写成了/，或者路径里有中文空格）。
   解决方案：
   ✅ 新手无脑方案：把py文件直接拖到要重命名的文件所在文件夹，配置项target_dir = "."不改，绝对零错误！
   ✅ 进阶方案：Windows路径用双反斜杠C:\\用户\\桌面\\照片，或在路径前加r：r"C:\用户\桌面\照片"。

❌ 坑2：把「文件夹」也一起重命名了（第二高频坑）

现象：文件夹里的子文件夹和文件一起被改名，导致文件夹结构混乱。
原因：代码没有过滤文件夹，os.listdir()会获取文件夹里的「所有内容」（文件+文件夹）。
解决方案：
✅ 代码里必须加这句：if os.path.isdir(old_file_path): continue→ 检测到是文件夹就跳过，上面两个版本的源码都已内置这句，放心用！

❌ 坑3：重命名时「覆盖已有文件」，导致文件丢失（最危险的坑！）

现象：运行后发现部分文件不见了，提示FileExistsError: [WinError 183] 当文件已存在时，无法创建该文件。
原因：新文件名和文件夹里已有的文件名重复，比如文件夹里已有旅行_001.jpg，代码又生成一个旅行_001.jpg，系统会直接覆盖原文件！
解决方案：
✅ 重命名前必做备份：批量重命名前，先把目标文件夹复制一份备份，哪怕改错了也能恢复；
✅ 代码优化：在重命名前加判断，如果新文件已存在，自动加编号（比如旅行_001_1.jpg），源码可加这句：

# 新增：如果新文件已存在，自动加后缀避免覆盖whileos.path.exists(new_file_path):count+=1new_file_name=f"{prefix_name}{count:0{num_length}d}{file_ext}"new_file_path=os.path.join(target_dir,new_file_name)

❌ 坑4：中文文件名/中文路径 乱码（Windows专属坑）

现象：运行后文件名变成一堆问号???，或提示编码错误UnicodeEncodeError。
原因：Windows系统的默认编码是gbk，Python默认是utf-8，编码不匹配导致中文乱码。
解决方案：
✅ 在代码最顶部添加两行万能代码，一劳永逸解决所有中文乱码问题：

importsys sys.stdout.reconfigure(encoding='utf-8')# 解决中文输出乱码os.environ['PYTHONIOENCODING']='utf-8'# 解决中文路径乱码

❌ 坑5：批量修改了「隐藏文件/系统文件」（比如桌面的ini、sys文件）

现象：运行后发现文件夹里多了一些不知名的文件被改名，甚至系统报错。
原因：Windows/Mac系统会在文件夹里生成「隐藏的系统文件」（比如.DS_Store、desktop.ini），这些文件默认隐藏，os.listdir()也会读取到。
解决方案：
✅ 代码里加过滤，跳过隐藏文件/系统文件，推荐加这几句：

# 跳过隐藏文件（文件名以.开头）和系统文件iffile_name.startswith(".")orfile_name=="desktop.ini":continue

❌ 坑6：跨盘符重命名失败（比如C盘文件改到D盘）

现象：提示OSError: [WinError 17] 系统无法将文件移到不同的磁盘驱动器。
原因：os.rename()只能在同一个盘符内重命名/移动文件，跨盘符会失效。
解决方案：
✅ 需求是「跨盘符移动+重命名」：改用shutil.move()，需要导入import shutil，替换os.rename()即可；
✅ 日常需求：不要跨盘符，把文件复制到目标盘符后再重命名。

❌ 坑7：权限不足，无法重命名文件

现象：提示PermissionError: [WinError 5] 拒绝访问。
原因：文件正在被打开（比如图片在看图软件里、文档在Word里），或者文件是只读属性、系统保护文件。
解决方案：
✅ 关闭所有正在打开该文件的软件；
✅ 右键文件 → 属性 → 取消「只读」勾选；
✅ 不要尝试重命名系统盘的系统文件（比如C:\Windows里的文件）。

❌ 坑8：批量重命名后，想恢复原文件名却没办法（后悔坑）

现象：改完文件名后觉得不好看，想改回原来的名字，但已经记不住原文件名了。
解决方案：
✅ 黄金原则：批量操作前，先备份！备份！备份！复制一份文件夹，在备份里操作，原文件不动，绝对安全；
✅ 进阶技巧：代码里加「日志记录」，把原文件名和新文件名保存到重命名日志.txt，想恢复时可反向重命名。

五、锦上添花：3个实用优化技巧（代码片段，直接加）

不用改核心逻辑，只需要加几行代码，就能让你的工具更强大，满足更多个性化需求，都是日常高频用到的，推荐加上：

✅ 技巧1：只重命名「指定后缀」的文件，过滤其他文件

比如只重命名jpg/png图片，不碰文档；只重命名txt/pdf文档，不碰视频。

源码里已经内置这个功能，就是配置项的file_suffix = ".jpg"，留空则处理所有文件。

✅ 技巧2：倒序编号/自定义编号规则

比如想让文件从100开始编号，或者从99倒序到1，只需要改两行：

start_num=100# 起始编号count=start_num# 倒序编号：count -=1 即可

✅ 技巧3：批量添加「后缀」而不是前缀

比如想在文件名后面加「_最终版」，代码里修改这行即可：

# 原前缀：prefix_name + 编号 + 后缀# 改后缀：文件名 + _最终版 + 编号 + 后缀new_file_name=f"{file_name_only}_最终版_{count:0{num_length}d}{file_ext}"

六、最后：安全须知 & 总结

✅ 安全三原则（永远遵守，零风险）

1. 先备份，再操作：批量重命名前，复制一份文件夹，在备份里运行工具，原文件绝对安全；
2. 先测试，再批量：如果有几百个文件，先在文件夹里放2-3个文件测试代码，确认没问题后再批量运行；
3. 不碰系统文件：不要用工具重命名C盘系统文件、U盘里的引导文件，只处理自己的文档/照片/视频。

✅ 保姆级总结

本次实战的批量重命名工具，零基础能写、能改、能用，核心代码只有几十行，用到的都是Python最基础的文件操作知识，却能解决日常工作中最头疼的文件整理问题。
你不需要记住所有代码，只需要：

1. 复制源码，保存为py文件；
2. 改配置项（前缀、编号、文件后缀）；
3. 放到目标文件夹，双击运行。

避坑指南是核心，记住那些必踩的坑和解决方案，你的工具就不会出任何问题。这个工具写完后，以后整理文件再也不用手动改名，几秒搞定，效率直接拉满！

✅ 最后一句话

Python办公自动化的核心，从来不是写多复杂的代码，而是用最简单的代码，解决最实际的问题。这个批量重命名工具，就是最好的入门实战案例，祝你用得舒心！🚀