Python批量重命名文件脚本实战：从环境搭建到os模块应用

脚本专家

很多Python新手学完基础语法后，最大的困惑是不知道如何把知识点落到实际代码里。本文围绕一个真实需求——批量重命名文件夹里的文件，完整梳理Python环境搭建、核心语法要点，并给出可直接运行的脚本。整个流程不涉及复杂底层原理，适合刚入门的朋友照着操作并理解关键代码。

一、环境搭建的两个关键点

Python安装本身不复杂，但Windows用户要特别注意：安装时务必勾选“Add Python to PATH”。这一步如果漏掉，安装完成后在cmd里输入python会提示命令不存在。勾选之后，打开命令提示符执行：

2. python --version

复制代码

如果能正常输出版本号，说明环境可用。如果之前没有勾选PATH，可以重新运行安装程序勾选修复，也可以手动把Python安装目录和Scripts目录加入系统环境变量。

版本方面，不建议新手同时安装多个Python版本。优先选择3.10到3.12之间的稳定版本，太新的版本可能遇到部分第三方库尚未兼容的问题。

IDE方面，PyCharm社区版是免费且对新手友好的选择。安装后新建项目，选择已装好的Python解释器，然后新建.py文件即可写代码。如果电脑配置一般，也可以用VS Code加Python插件，更轻量。

二、编写批量重命名脚本前必须掌握的语法

Python属于弱类型语言，变量直接赋值即可，不需要声明类型。常见的数据类型包括字符串、整数、浮点数、布尔值、列表等。列表用方括号定义，有序且可修改。

2. name = "Python学习"
3. age = 2
4. score = 95.5
5. my_list = ["java","python","go"]
6. print(name, age, score)
7. print(my_list[1])

复制代码

条件判断使用if-elif-else，循环有for和while两种。Python用缩进划分代码块，同一个代码块内的缩进空格数必须一致，这是新手最容易踩的坑。

2. score = 85
3. if score >= 90:
4.     print("优秀")
5. elif score >= 60:
6.     print("及格")
7. else:
8.     print("不及格")
10. lang_list = ["Python","Java","C++"]
11. for lang in lang_list:
12.     print(f"编程语言：{lang}")

复制代码

函数用def关键字定义，可以把重复逻辑封装起来复用：

2. def calc_sum(a, b):
3.     return a + b
5. res = calc_sum(10, 20)
6. print(res)

复制代码

三、文件批量重命名脚本实现

场景很常见：一个文件夹里有很多图片或文档，名字乱七八糟，想统一改成有规律的前缀加序号。手动改效率太低，用Python的os模块几十行代码就能解决。

运行脚本前建议先备份原始文件，防止误操作。完整代码如下：

2. import os
4. def batch_rename(folder_path, prefix="file"):
5.     """
6.     folder_path：目标文件夹路径
7.     prefix：文件名称前缀
8.     """
9.     if not os.path.exists(folder_path):
10.         print("文件夹路径不存在！")
11.         return
13.     count = 1
14.     # 遍历文件夹内所有内容
15.     for filename in os.listdir(folder_path):
16.         old_path = os.path.join(folder_path, filename)
17.         # 跳过子文件夹，只处理文件
18.         if os.path.isfile(old_path):
19.             # 分离文件名和后缀，保证重命名不丢格式
20.             suffix = os.path.splitext(filename)[1]
21.             new_name = f"{prefix}_{count}{suffix}"
22.             new_path = os.path.join(folder_path, new_name)
23.             os.rename(old_path, new_path)
24.             count += 1
26.     print(f"处理完成，一共修改{count - 1}个文件")
28. if __name__ == "__main__":
29.     # 修改这里为你自己的文件夹路径
30.     target_folder = r"D:\test_files"
31.     batch_rename(target_folder, prefix="picture")

复制代码

这段脚本的核心逻辑并不复杂，关键在于os模块几个内置函数的配合：

- os.listdir(folder_path)：读取指定文件夹下的全部条目，包括文件和子目录。
- os.path.join(folder_path, filename)：拼接完整的文件路径，保证跨平台路径分隔符正确。
- os.path.isfile(old_path)：判断当前条目是否为文件，子文件夹会被跳过，避免误改目录。
- os.path.splitext(filename)：把文件名和后缀拆开，比如report.pdf拆成report和.pdf，新文件名直接复用原后缀就不会破坏格式。
- os.rename(old_path, new_path)：执行实际的重命名操作。

运行后，目标文件夹里的文件会变成picture_1.jpg、picture_2.png这种统一格式。count从1开始，每处理一个文件自增1，最终输出总共修改的文件数量。

这个脚本还可以继续扩展，比如只处理指定后缀的文件，或者把日期时间戳加入文件名。对新手来说，基于这个案例去改动，比单纯看语法书更容易理解os模块的用途。

四、学习过程中的避坑建议

不要只看视频或教程然后眼高手低，看懂和会写之间需要大量敲代码练习。报错不要怕，控制台红色的提示会直接指出错误行号和原因，学会阅读报错是程序员的基本功。遇到常见需求时，先查Python标准库，很多功能都不用自己从零实现。学习路径也要循序渐进，先完成小脚本，再尝试更大的项目。

本文从环境搭建讲到基础语法，最后落成一个可以实际使用的批量重命名脚本，整个过程就是Python入门的一个缩影：安装环境、掌握变量/分支/循环/函数、调用标准库解决真实问题。学完这个案例，可以继续往数据分析、自动化脚本或Web后端方向深入，但前提是持续写代码、积累项目经验，而不是停留在看教程的阶段。