专业接各种小工具软件及爬虫软件开发，联系Q：2391047879

Python小工具资源库 > 小工具 >

使用Argparse的命令行文件批量重命名工具

发布时间: 2025-06-25 16:06:03 浏览量: 本文共包含857个文字，预计阅读时间3分钟

命令行文件批量重命名工具：用Python和Argparse解放双手

在日常工作中，文件批量重命名是一个高频且枯燥的需求。无论是整理照片、归档文档，还是处理代码文件，手动逐个修改文件名不仅效率低下，还容易出错。为此，基于Python的`argparse`库开发的命令行工具，提供了一种灵活且高效的解决方案。

功能定位与核心逻辑

该工具的核心逻辑是通过正则表达式匹配或通配符规则，批量修改指定目录下的文件名。支持添加前后缀、按序号重排、自定义替换规则等功能。例如，将杂乱的照片文件统一命名为“2023_旅行_001.jpg”，或将代码文件从“old_module_1.py”替换为“new_module_v1.py”。

通过命令行参数，用户无需修改代码即可动态调整重命名规则，适合不同场景的定制化需求。

快速上手指南

1. 安装依赖

工具基于Python标准库开发，仅需确保系统已安装Python 3.6及以上版本，无需额外安装第三方包。

2. 基础命令格式

```bash

python rename_tool.py [目录路径] [参数选项]

```

例如，对`./docs`目录下的文件添加日期前缀：

```bash

python rename_tool.py ./docs --prefix "20231001_

```

3. 关键参数说明

`--prefix` / `--suffix`：为文件名添加统一的前缀或后缀。

`--replace "old,new"`：将文件名中的“old”替换为“new”，支持正则表达式。

`--sequence`：按数字序号重新排列文件（如file_001、file_002）。

`--dry-run`：模拟执行，预览重命名结果而不实际修改文件。

实际应用案例

案例1：整理摄影作品

摄影师需要将数百张图片从“DSC_1234.jpg”重命名为“西藏行摄_1234.jpg”：

```bash

python rename_tool.py ./photos --replace "DSC_,西藏行摄_" --suffix ".jpg

```

案例2：代码版本升级

开发者将模块文件从“utils_v1.py”升级到“utils_v2.py”：

```bash

python rename_tool.py ./src --replace "v1,v2

```

案例3：按创建时间排序

结合系统命令获取文件时间戳，生成“20231001_报告.pdf”格式：

```bash

python rename_tool.py ./reports --prefix $(date +%Y%m%d)_

```

注意事项与边界

1. 文件备份：重命名操作不可逆，建议通过`--dry-run`预览结果，或提前备份目录。

2. 命名冲突：若新文件名已存在，工具默认跳过处理，可通过`--force`覆盖（慎用）。

3. 通配符限制：避免使用``或`?`直接匹配文件，优先用正则表达式精确控制范围。

通过合理设计参数组合，这一工具可覆盖90%以上的批量重命名需求，且代码开源，支持进一步扩展自定义规则。对于更复杂的场景（如按内容重命名），可结合文件元信息（如EXIF、创建时间）进行二次开发。