一键批量替换文件夹名关键字：Windows批处理、PowerShell与Python实战指南

在工作中经常遇到这样的场景：一批下载的素材文件夹命名混乱，某个项目下的十几个子目录都带着旧的日期前缀，或者用脚本生成了一堆目录后发现命名规则变了。这时如果手动一个个重命名，效率极低且容易出错。本文将围绕“一键批量替换文件夹名关键字”这个需求，给出在 Windows 环境下最实用的几种实现方案，包括批处理脚本、Python 脚本和 PowerShell 命令，并附带完整的代码示例、运行效果说明和常见问题排查思路。无论你是编程新手还是常与文件打交道的开发者，都能直接照着操作落地。

1. 批量重命名的应用场景与核心思路

1.1 批量重命名解决什么问题

批量替换文件夹名中的关键字，本质上是“文本替换”在文件系统层面的应用。很多情况下文件夹的命名是有规律的，比如：

• 素材包中的目录统一带有“_v2”后缀，需要改成“_final”；
• 项目目录中残留有“临时_”“备份_”等前缀，需要批量清理；
• 从旧系统迁移过来的文件夹名包含不规范的字符，需要统一替换为下划线或指定关键词；
• 对一批实验数据目录重新编号，需要替换掉名称中的日期或批次信息。

如果文件夹数量少，手动操作还能接受；但数量上升到几十个、上百个时，手动处理不仅耗时，而且容易漏改、误改。脚本化批量替换的价值在于：一次编写，多次复用，结果可预期，操作可记录。

1.2 批量替换的底层逻辑

批量替换文件夹名的核心逻辑只有三步：

1. 遍历指定目录下的所有子文件夹；
2. 判断文件夹名是否包含需要替换的旧关键字；
3. 如果包含，则将旧关键字替换为新关键字，并调用重命名操作。

不同的实现方案，区别主要在于“遍历方式”和“重命名调用方式”。理解了这一点，后续写代码时就不会被各种语言细节困住，而是能抓住主干逻辑。

需要特别留意的是，文件系统命名在不同平台上的限制有所差异。在 Windows 中，文件夹名不能包含\ / : * ? " < > |这些字符，也不允许以点号结尾；在 Linux/macOS 上则相对宽松，但也有正斜杠不能出现在文件名中这样的硬性规定。因此进行替换操作时，要提前判断替换后的名称是否合法。

1.3 常见实现方案对比

以下章节会逐一给出这三种方案的完整代码和运行说明。你可以根据自己电脑的环境选择最顺手的一种。

2. 环境准备与前置说明

2.1 本文涉及的运行环境

为了保证读者能顺利复现，这里先说明示例代码在什么样的环境中运行：

• 操作系统：Windows 10 / Windows 11（批处理和 PowerShell 为系统自带）
• Python 版本：Python 3.8 及以上（本文语法兼容 3.8 到 3.12）
• 开发工具：记事本即可运行脚本，推荐使用 VS Code 或 Notepad++ 以便查看编码格式

版本需要根据你的项目实际情况调整，本文示例以常见环境为例，重点演示配置思路。如果你的 Python 版本较低，建议升级到 3.8 以上，避免因语法差异导致运行失败。

2.2 测试目录结构说明

在开始写脚本之前，先在本地准备一个用于测试的目录，模拟真实场景。假设我们在D:\test_batch_rename下建立了以下文件夹：

D:\test_batch_rename ├── 项目A_旧版 ├── 项目B_旧版 ├── 项目C_旧版 ├── 项目D_最终版 └── 说明文档.txt

现在的需求是：把目录下所有文件夹名中的“_旧版”替换成“_v2”。预期替换后目录结构如下：

D:\test_batch_rename ├── 项目A_v2 ├── 项目B_v2 ├── 项目C_v2 ├── 项目D_最终版 └── 说明文档.txt

注意：说明文档.txt是文件而不是文件夹，默认不纳入本次重命名范围，需要在代码中通过判断显式排除掉。

3. 方案一：批处理脚本实现批量替换

3.1 批处理基本语法说明

批处理是最轻量的批量重命名方式，不需要安装任何软件。它的核心命令是ren（rename 的缩写）。一个最简单的重命名命令如下：

ren "项目A_旧版" "项目A_v2"

但这样只能处理单个文件夹，达不到“批量”的效果。在批处理中实现批量操作，通常需要借助for /d循环遍历当前目录下的所有文件夹。for /d的作用是只匹配目录，不会匹配普通文件。

3.2 完整批处理脚本

下面是一个可直接复制保存的.bat脚本。在脚本所在目录下运行，它会将该目录下所有包含指定关键字的文件夹名进行替换。

@echo off setlocal enabledelayedexpansion rem 在这里配置需要替换的关键字 set "old=旧版" set "new=v2" for /d %%i in (*) do ( set "name=%%i" set "newName=!name:%old%=%new%!" if not "!name!"=="!newName!" ( ren "%%i" "!newName!" echo 已重命名: %%i -^> !newName! ) ) echo 批量替换完成。 pause

脚本内容解释如下：

• @echo off：关闭命令行回显，使脚本运行时不逐个打印命令本身；
• setlocal enabledelayedexpansion：启用延迟变量展开。批处理中在for循环内修改变量值后，需要用!变量名!取值，而不是%变量名%；
• set "old=旧版"和set "new=v2"：设置旧关键字和新关键字；
• for /d %%i in (*) do (...)：遍历当前目录下的所有文件夹；
• set "name=%%i"：将当前文件夹名保存到变量name；
• set "newName=!name:%old%=%new%!"：这是批处理中的字符串替换语法，表示把name中所有等于old变量的内容替换为new变量的内容；
• if not "!name!"=="!newName!"：只有当新旧名称不同时才执行重命名，避免无意义的操作；
• pause：窗口暂停，方便查看执行结果。

3.3 运行方式与注意事项

将上述代码保存为batch_rename.bat，放在D:\test_batch_rename目录下，双击运行即可。也可以打开命令行窗口，切换到该目录后执行：

batch_rename.bat

运行结果大致如下：

已重命名: 项目A_旧版 -> 项目A_v2 已重命名: 项目B_旧版 -> 项目B_v2 已重命名: 项目C_旧版 -> 项目C_v2 批量替换完成。 请按任意键继续. . .

这里有几个注意事项：

1. 批处理脚本会修改old和new变量，比如set "old=【临时】"，但如果旧关键字中包含了特殊的转义字符（如&、%、!等），直接写在set语句中可能出现意料之外的解析问题，这种情况下建议优先选择 PowerShell 或 Python；
2. 脚本只会处理当前目录下的直接子文件夹，不会递归到更深层目录。如果需要递归处理，需要写成for /d /r %%i in (*) do (...)，但请注意递归时路径会包含更长的目录结构，重命名前需要先获取文件名部分，否则会因路径和文件名混淆而出错；
3. 批处理默认使用系统编码。如果你的 Windows 系统使用 GBK 编码且脚本中包含中文关键字，保存脚本文件时应选择 ANSI 编码。如果使用的是 UTF-8 编码，命令行窗口中的中文可能显示为乱码。推荐做法：保存为 ANSI（GBK）编码，或者将关键字改为英文字符串。

4. 方案二：PowerShell 脚本实现批量替换

4.1 PowerShell 的优势

PowerShell 是 Windows 上比 cmd 更现代的脚本环境，处理文本编码的能力更强，而且在 Windows 10/11 中已经预装。如果你需要在多个目录之间切换操作对象，或者希望更加精细地控制重命名的筛选条件，PowerShell 是比批处理更稳的选择。

PowerShell 中重命名文件夹的核心命令是Rename-Item，遍历文件夹用Get-ChildItem -Directory。

4.2 完整 PowerShell 脚本

将下面的代码保存为batch_rename.ps1：

# 设置要操作的根目录 $rootDir = "D:\test_batch_rename" # 设置替换规则 $oldKeyword = "旧版" $newKeyword = "v2" # 遍历所有子文件夹 Get-ChildItem -Path $rootDir -Directory | ForEach-Object { $folder = $_ $newName = $folder.Name.Replace($oldKeyword, $newKeyword) if ($newName -ne $folder.Name) { Rename-Item -Path $folder.FullName -NewName $newName Write-Host "已重命名: $($folder.Name) -> $newName" } } Write-Host "批量替换完成。"

脚本说明：

• $rootDir指定要遍历的根目录；
• Get-ChildItem -Directory只获取目录项，不会把普通文件列入操作范围；
• $folder.Name.Replace()是 .NET 字符串的 Replace 方法，它会替换所有匹配到的子串；
• Rename-Item -NewName执行重命名，-Path指定完整路径，避免在切换到其他目录时出现路径错误。

如果你希望递归处理所有嵌套的子文件夹，只需要把-Directory后面的命令改为：

Get-ChildItem -Path $rootDir -Directory -Recurse | ForEach-Object { ... }

但需要提醒的是，递归重命名时可能会遇到“先改父文件夹、后改子文件夹，导致子文件夹路径失效”的问题。更稳妥的做法是先遍历所有目录并收集路径和新的名称，再从最深层目录开始重命名，或者只处理深度为 1 的文件夹，避免路径失效。

4.3 如何解决 PowerShell 脚本执行被禁止的问题

默认情况下，Windows 出于安全考虑禁止运行未签名的 PowerShell 脚本。双击运行.ps1文件通常会被系统阻止，提示“无法加载文件，因为在此系统上禁止运行脚本”。

解决办法有两种：

第一种，在当前用户范围内修改执行策略为RemoteSigned（允许运行本地脚本，远程脚本需要签名）。以管理员身份打开 PowerShell，执行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

输入Y确认即可。这个设置只影响当前用户，不会对系统全局造成安全风险。

第二种，不使用脚本文件，直接在 PowerShell 命令行中逐行粘贴脚本内容运行，但这种做法不适合多次复用。

4.4 PowerShell 字符串替换易踩坑点

需要注意Replace方法是“区分大小写”的，如果你要替换的关键字是英文字母，且希望不区分大小写，则不能直接使用.Replace()，需要使用正则表达式替换：

$newName = [System.Text.RegularExpressions.Regex]::Replace($folder.Name, $oldKeyword, $newKeyword, [System.Text.RegularExpressions.RegexOptions]::IgnoreCase)

这种方法对中文替换没有影响，但如果关键字包含正则表达式的特殊字符（如[、]、.、*），则需要先经过[Regex]::Escape()处理，否则会被当作正则元字符解析。

5. 方案三：Python 脚本实现批量替换

5.1 为什么推荐 Python 方案

Python 是三种方案中功能最均衡的。它不仅可以在 Windows 上运行，也可以原样迁移到 Linux 或 macOS 上。更关键的是，Python 脚本可以很方便地加入白名单过滤、黑名单排除、日志记录、撤销操作备份等功能，适合处理较复杂的批量重命名需求。

5.2 基础版：遍历目录并替换文件夹名

以下代码保存为batch_rename.py：

# -*- coding: utf-8 -*- import os def batch_rename_folder_keyword(root_dir, old_keyword, new_keyword): """ 批量替换指定目录下所有文件夹名称中的关键字 :param root_dir: 根目录路径 :param old_keyword: 需要被替换的旧关键字 :param new_keyword: 替换后的新关键字 """ if not os.path.exists(root_dir): print(f"目录不存在: {root_dir}") return renamed_count = 0 for item in os.listdir(root_dir): item_path = os.path.join(root_dir, item) # 只处理文件夹，不处理文件 if not os.path.isdir(item_path): continue # 检查旧关键字是否在文件夹名中 if old_keyword in item: new_name = item.replace(old_keyword, new_keyword) new_path = os.path.join(root_dir, new_name) # 确认新名称在目录中不存在，避免覆盖 if os.path.exists(new_path): print(f"重命名失败，目标名称已存在: {new_name}") continue os.rename(item_path, new_path) print(f"已重命名: {item} -> {new_name}") renamed_count += 1 print(f"批量替换完成，共处理 {renamed_count} 个文件夹。") if __name__ == "__main__": root_dir = r"D:\test_batch_rename" old_keyword = "旧版" new_keyword = "v2" batch_rename_folder_keyword(root_dir, old_keyword, new_keyword)

运行方式：

python batch_rename.py

运行结果示例：

已重命名: 项目A_旧版 -> 项目A_v2 已重命名: 项目B_旧版 -> 项目B_v2 已重命名: 项目C_旧版 -> 项目C_v2 批量替换完成，共处理 3 个文件夹。

5.3 进阶版：递归处理子目录并打印日志

如果是多层目录结构，上面的代码只会处理根目录下的直接子文件夹。为了递归处理所有层级的文件夹，可以借助os.walk，但这需要特别小心：os.walk默认自上而下遍历，如果在遍历过程中修改了目录名，可能会影响后续遍历路径。

为了解决这个问题，推荐先遍历收集所有符合条件的路径，然后再统一执行重命名。代码如下：

# -*- coding: utf-8 -*- import os def collect_folders(root_dir, old_keyword): """收集所有包含旧关键字的文件夹路径，从最深层级开始排序""" folders = [] for current_dir, dirs, files in os.walk(root_dir): for dir_name in dirs: if old_keyword in dir_name: full_path = os.path.join(current_dir, dir_name) folders.append(full_path) # 按路径深度降序排列，先处理深层目录 folders.sort(key=lambda x: x.count(os.sep), reverse=True) return folders def batch_rename_recursive(root_dir, old_keyword, new_keyword): folders = collect_folders(root_dir, old_keyword) renamed_count = 0 for old_path in folders: parent_dir = os.path.dirname(old_path) old_name = os.path.basename(old_path) new_name = old_name.replace(old_keyword, new_keyword) new_path = os.path.join(parent_dir, new_name) if os.path.exists(new_path): print(f"重命名失败，目标名称已存在: {new_name}") continue os.rename(old_path, new_path) print(f"已重命名: {old_path} -> {new_path}") renamed_count += 1 print(f"递归批量替换完成，共处理 {renamed_count} 个文件夹。") if __name__ == "__main__": root_dir = r"D:\test_batch_rename" old_keyword = "旧版" new_keyword = "v2" batch_rename_recursive(root_dir, old_keyword, new_keyword)

这里的关键在于“先收集、后重命名”和“按路径深度降序排列”。如果先处理上层目录，再处理下层目录，那么下层目录的路径会因上层目录改名而失效，导致os.rename抛出找不到路径的异常。按深度优先处理可以避免这个问题，因为子目录的完整路径中即使包含上层目录名，只要上层目录还没被重命名，路径就依然有效。

5.4 Python 方案中加入安全保护

在实际工程项目中，批量重命名属于“不可逆操作中的可逆性较差”的操作——一旦执行，原文件夹名就不存在了。为了提升安全性，建议在脚本中加入以下保护措施：

1. 打印待修改清单，并要求输入yes确认后才执行：

confirm = input(f"即将重命名 {renamed_count} 个文件夹，是否继续？(输入 yes 确认)") if confirm != "yes": print("已取消操作。") exit()

2. 在重命名前先生成一份清单文件，便于审计：

with open("rename_log.txt", "w", encoding="utf-8") as f: f.write(f"{os.path.basename(old_path)}\t{new_name}\n")

3. 如果是重要目录，优先复制测试目录做演练，确认结果无误后再对真实目录执行。

6. 进阶思路：用 Python 实现“拖拽即用”的一键脚本

6.1 需求背景

虽然上面的 Python 脚本已经能够完成批量替换，但每次都要打开编辑器修改root_dir、old_keyword、new_keyword这些变量的值，对不熟悉代码的同事来说不太友好。如果希望做成一个“双击运行、输入参数”的傻瓜式工具，可以改用input()交互式输入的方式。

6.2 交互式一键脚本示例

# -*- coding: utf-8 -*- import os import sys def main(): print("=== 一键批量替换文件夹名关键字工具 ===") root_dir = input("请输入要操作的目录路径（直接回车则使用当前目录）: ").strip() if not root_dir: root_dir = os.getcwd() old_keyword = input("请输入需要被替换的旧关键字: ").strip() if not old_keyword: print("旧关键字不能为空，程序退出。") sys.exit(1) new_keyword = input("请输入替换后的新关键字: ").strip() if not os.path.exists(root_dir): print(f"错误：目录不存在 {root_dir}") sys.exit(1) print(f"\n目录: {root_dir}") print(f"替换规则: 将文件夹名中的【{old_keyword}】替换为【{new_keyword}】") preview_count = 0 for item in os.listdir(root_dir): if os.path.isdir(os.path.join(root_dir, item)) and old_keyword in item: new_name = item.replace(old_keyword, new_keyword) print(f" {item} -> {new_name}") preview_count += 1 if preview_count == 0: print("未找到任何包含旧关键字的文件夹。") return confirm = input(f"\n以上 {preview_count} 个文件夹将被重命名，是否继续？(输入 yes 确认): ") if confirm != "yes": print("操作已取消。") return renamed_count = 0 for item in os.listdir(root_dir): item_path = os.path.join(root_dir, item) if os.path.isdir(item_path) and old_keyword in item: new_name = item.replace(old_keyword, new_keyword) new_path = os.path.join(root_dir, new_name) if os.path.exists(new_path): print(f"重命名失败，目标名称已存在: {new_name}") continue os.rename(item_path, new_path) renamed_count += 1 print(f"\n操作完成，共重命名 {renamed_count} 个文件夹。") if __name__ == "__main__": main()

运行这个脚本后，程序会依次询问目录路径、旧关键字、新关键字，并在执行前展示预览清单。由于有了确认环节，误操作的概率会明显降低。这也是工程上推荐的做法：先预览，再确认，最后执行。

7. 常见问题与排查思路

在实际使用中，批量重命名脚本可能会出现各种问题。下面整理了一份高频问题和排查建议：

7.1 如何避免误操作

以下几点建议可以帮助你避免误操作带来的损失：

1. 先在一层目录结构的小范围测试目录中验证脚本，再用于正式数据；
2. 如果目录名称包含重要信息，建议先手动复制一份完整目录作为备份；
3. 脚本中输出详细的日志，至少包含“原名称 -> 新名称”的映射，方便后续追查；
4. 如果重命名不可逆且目录数量极大，建议先导出清单到文本文件，由人工审核后再执行。

7.2 Windows 资源管理器正在使用文件怎么办

Windows 下经常出现“另一个程序正在使用此文件”导致的os.rename失败。原因是资源管理器窗口当前停留在目标目录内，或者某个软件的默认工作目录指向了该文件夹。解决办法是关闭相关窗口，或者将脚本的根目录路径设置为不包含正在被占用的上级目录。还有一种情况是杀毒软件对大量重命名操作进行临时扫描，导致瞬间占用。遇到这种情况时，可以稍后重试或调整脚本执行速度。

8. 最佳实践与工程建议

批量替换文件夹名看起来是个小功能，但如果能遵循一定的工程实践，可以避免很多不必要的麻烦。

8.1 命名规则先行

在使用脚本批量替换之前，建议先梳理清楚命名规范。比如确定使用哪种分词符（下划线、中划线、空格）、日期格式（YYYYMMDD 还是 YYYY-MM-DD）、版本号规则（v1.0.0 还是 v2）。只有规则清晰了，替换关键字才有依据。如果命名规范本身混乱，替换后依然混乱，属于“治标不治本”。

8.2 配置与代码分离

对于经常需要调整关键字的场景，不要把替换关键字硬编码在逻辑代码中。推荐改成读取配置文件（如config.json）或使用交互式输入的方式。这样既方便非技术人员使用，也避免了频繁修改代码导致引入错误。

下面是一个简单的config.json示例：

{ "root_dir": "D:\\test_batch_rename", "old_keyword": "旧版", "new_keyword": "v2", "recursive": false, "skip_if_exists": true, "log_file": "rename_log.txt" }

在 Python 中读取：

import json with open("config.json", "r", encoding="utf-8") as f: config = json.load(f) root_dir = config["root_dir"] old_keyword = config["old_keyword"] new_keyword = config["new_keyword"]

8.3 增加日志与审计

批量操作应该留下可追踪的记录。建议每次执行时输出三样东西：操作时间、原始名称、新名称。如果需要更严谨的审计，可以在重命名前将原始名称和新名称都写入 CSV 文件，这样即使重命名后发现有问题，也可以根据日志快速写一个“反向回滚”脚本。

8.4 测试与演练

重要目录操作前，务必在测试目录中进行完整演练。演练时不仅要注意是否有报错，还要确认替换后的文件夹名完全符合预期，尤其是多个关键字重叠的情况。比如旧关键字是“项目”，但替换后可能与文件夹名中其他部分的语义产生冲突，这种问题往往要在整体预览时才能发现。

8.5 命名冲突处理策略

当新名称与已有文件夹名冲突时，可以选择的策略有三种：

• 跳过：保留原名称，记录日志；
• 覆盖：删除或合并已有文件夹（风险很高，不建议默认启用）；
• 加序号：在名称末尾追加_1、_2等序号。

工程实践中推荐“跳过”作为默认策略，因为这是最安全的方式。需要覆盖时，应在代码中显式传入参数确认，避免误操作。

9. 总结

批量替换文件夹名关键字是文件管理中的高频需求，实现起来并不复杂，但要做到“安全、可靠、可复用”就需要在方案设计和代码细节上多花心思。本文给出了 Windows 批处理、PowerShell 和 Python 三种实现方案，分别适合不同技术背景和不同复杂度的场景。如果你的需求只是临时处理一次且环境为 Windows，批处理脚本最快；如果需要处理中文路径、递归目录，PowerShell 更稳定；如果需要跨平台、加入确认机制和日志审计，Python 是首选。在实际操作中，建议先用测试目录演练一遍，确认脚本输出符合预期后再对真实目录执行。无论选择哪种方案，加上预览确认、冲突检查和日志记录，都能让批量重命名变得更安全。如果你在操作过程中遇到其他异常情况，欢迎在评论区说明操作系统版本、脚本类型和具体报错内容，方便继续一起排查。