你是不是也遇到过这样的场景某个目录下面几十个文件夹名称里都带着同一个关键字需要全部替换掉。手动一个一个右键重命名不仅慢还容易出错如果目录层级再深一点那效率就更低了。本文将围绕“一键批量替换文件夹名关键字”这个需求给出多种可直接落地的解决方案覆盖 Windows 批处理、PowerShell、Python 三种方式并说明其中的核心原理、高频报错和工程化建议。无论你是刚接触脚本的新手还是日常需要处理文件整理的开发或运维同学都能从中找到一套适合自己的做法。1. 需求背景与适用场景1.1 这个需求解决什么问题批量替换文件夹名关键字本质上是一次“局部字符串替换”操作。前面说的“关键字”指的是文件夹名称中反复出现的一段文本比如某个版本号、日期、项目代号、渠道标记等等。常见的需求类型有一批文件夹名中包含“2024”需要统一替换为“2025”。下载的资源文件夹名带有推广后缀需要批量去掉。项目目录从“v1”变更为“v2”希望一次性改完。批量整理测试数据需要把目录中的某些标记改成统一规范。这类操作如果全手动完成最大的风险其实不是时间而是“漏改”和“误改”。手动操作时一旦文件夹数量多很容易在一个目录上重复确认或者不小心改了不该动的目录。用脚本批量处理只要规则定义清楚就能保证一次执行、结果一致。1.2 为什么需要多种实现方式很多教程只给一种做法但实际工程环境中不同人有不同的工具习惯和系统权限如果你的电脑是 Windows且只是偶尔处理一两次bat 脚本最方便不需要安装任何额外环境。如果目录层级复杂或者需要用到正则表达式PowerShell 是 Windows 自带的更强大选项。如果需要跨平台执行或者要对接后续的数据处理流程Python 脚本更加灵活。另外在实际项目中还经常会遇到需要“先看一遍替换结果确认无误再执行”的需求这时脚本里就需要加入预览模式。后面我会在每一种方案中体现这一点。2. 方案选型与前置知识2.1 三种脚本的定位对比方案适用系统需要安装易用程度适用场景bat 批处理Windows不需要最简单单层目录、临时处理、无 Python 环境PowerShellWindows系统自带中等多层目录、正则替换、权限控制PythonWindows / Linux / macOS需安装 Python灵活跨平台、复杂规则、需要集成到程序2.2 文件与文件夹重命名的底层逻辑在 Windows 系统中无论手动还是脚本重命名本质都是对文件系统的一项“目录项修改操作”。脚本方式之所以能批量处理是因为它可以循环遍历目录项逐一判断名称是否包含目标关键字然后调用系统 API 完成重命名。理解这一点对你排查问题很有帮助重命名并不是“复制粘贴”不会产生新的文件内容所以速度很快。如果目标文件夹已存在同名项目重命名会失败系统会提示冲突。如果文件夹正被某个程序占用重命名同样会失败。所以批量替换的核心流程就是遍历目录列表 - 判断名称是否包含关键字 - 构造新名称 - 检查冲突 - 执行重命名后面的脚本都遵循这个流程只是语法不同。2.3 关键字与通配符、正则表达式的区别先澄清一个容易混淆的概念这里的“关键字”不是编程语言中的关键字比如if、for而是一个普通字符串。在文件重命名场景中我们关心的是如何在字符串中定位并替换目标文本。不同脚本使用的匹配方式不同bat 中使用变量替换属于“纯字符串替换”。PowerShell 默认支持正则表达式因此需要留意特殊字符。Python 调用字符串的replace()方法时也是纯字符串替换如果使用re.sub()则支持正则。例如如果你想替换的关键字是2024.01在正则表达式中.是特殊符号表示“任意字符”直接使用正则替换会得到一个预料之外的结果。这个细节我会在第 4 节专门说明。3. 方案一bat 批处理脚本实现3.1 最简单的 bat 脚本先写一个最基础的版本适合处理单层目录下的文件夹重命名。echo off setlocal enabledelayedexpansion rem 在这里修改待替换和替换后的关键字 set old2024 set new2025 for /d %%d in (*) do ( set name%%d if not !name:%old%!!name! ( set newname!name:%old%%new%! ren %%d !newname! echo 已重命名: %%d --^ !newname! ) ) echo 批量替换完成。 pause把这 3 个核心点解释一下setlocal enabledelayedexpansion开启延迟变量扩展。因为我们在循环内部不断修改变量name和newname如果不开启延迟扩展!name!这种写法就不会得到预期的值。for /d %%d in (*)遍历当前目录下的所有目录名/d表示只匹配目录不处理文件。!name:%old%!去掉old后如果和原名称不同说明名称中确实包含关键字这比直接替换更安全可以避免不必要的重命名操作。运行方式把以上内容保存为rename.bat放到需要处理的目录下双击运行即可。3.2 支持指定路径的增强版上面的版本只能在当前目录下运行。实际使用中脚本往往放在任意位置需要处理的目标目录在其他路径。此时可以把目标路径作为一个变量传进来。echo off setlocal enabledelayedexpansion rem 目标路径请按需修改 set targetD:\workspace\test cd /d %target% set old2024 set new2025 for /d %%d in (*) do ( set name%%d if not !name:%old%!!name% ( set newname!name:%old%%new%! ren %%d !newname! echo 已重命名: %%d --^ !newname! ) ) echo 批量替换完成。 pause这段代码中cd /d %target%会切换到目标目录/d参数可以切换盘符。如果路径包含空格必须用引号包围否则命令会解析错误。3.3 bat 方案的核心局限bat 虽然方便但有两个关键坑编码问题。Windows 批处理默认使用 ANSI 编码中文环境为 GBK。如果你把上面的脚本保存为 UTF-8 编码中文关键字在运行时可能会乱码导致替换失败。建议在编辑器中另存为 ANSI 编码。特殊字符转义。如果关键字中包含、%、^等特殊字符批处理解析时可能出现意外行为需要额外转义。这种场景下我更推荐直接用 PowerShell 或 Python。3.4 bat 处理子目录中的文件夹严格来说for /d只能处理当前目录下的目录不会递归进入子目录。如果项目层级较多需要递归处理可以结合for /f和dir /ad /b /s实现echo off setlocal enabledelayedexpansion set targetD:\workspace\test set oldv1 set newv2 for /f delims %%d in (dir /ad /b /s %target% ^| sort /r) do ( set full%%d set name%%~nxd if not !name:%old%!!name! ( set newname!name:%old%%new%! set parent!full:\%name%! ren %%d !newname! echo 已重命名: %%d --^ !parent!\!newname! ) ) echo 批量替换完成。 pause这里使用sort /r的目的是让子目录优先于父目录被处理。因为如果先重命名父目录子目录路径就会发生变化基于旧路径的列表可能会失效。实际项目中递归处理文件夹时这个顺序问题很关键。4. 方案二PowerShell 脚本实现4.1 PowerShell 的优势PowerShell 是 Windows 自带的脚本环境相比 bat 拥有更强的字符串处理和对象管道能力。尤其适合以下场景需要递归处理。需要使用正则表达式做更灵活的匹配。希望重命名失败时能够捕获异常并继续处理。4.2 单层目录替换示例先看一个最简单的版本$old 2024 $new 2025 Get-ChildItem -Directory | Where-Object { $_.Name -like *$old* } | ForEach-Object { $newName $_.Name.Replace($old, $new) Rename-Item -Path $_.FullName -NewName $newName Write-Host 已重命名: $($_.Name) - $newName }说明Get-ChildItem -Directory只获取当前目录下的所有文件夹。Where-Object负责过滤名称中包含关键字的对象。$_.Name.Replace($old, $new)是 .NET 的字符串替换方法属于纯字符串替换不会把.当作正则符号。Rename-Item执行实际的重命名操作。在 PowerShell 中-like *$old*可以使用通配符但这里的*只是 PowerShell 的通配符与正则表达式无关。4.3 使用正则表达式替换如果希望支持更复杂的匹配规则可以使用-replace运算符$old 2024\. $new 2025- Get-ChildItem -Directory | Where-Object { $_.Name -match $old } | ForEach-Object { $newName $_.Name -replace $old, $new Rename-Item -Path $_.FullName -NewName $newName Write-Host 已重命名: $($_.Name) - $newName }注意$old中的\.是正则表达式写法表示匹配一个普通点号。如果直接用$_.Name.Replace($old, $new)则\.会按字面内容查找结果完全不一样。这一点非常容易踩坑。建议你在使用正则前先在 PowerShell 中测试匹配结果$testNames (2024.01, 202401, v2024.01) $testNames | ForEach-Object { if ($_ -match 2024\.) { Write-Host $_ 匹配成功 } else { Write-Host $_ 不匹配 } }4.4 递归处理子目录递归处理和 bat 类似同样需要考虑顺序。PowerShell 中可以直接使用Get-ChildItem -Directory -Recurse但要提醒一点直接遍历并重命名可能在处理到深层目录时触发路径失效问题。比较稳妥的做法是先收集目录列表再倒序处理$old v1 $new v2 $target D:\workspace\test $dirs Get-ChildItem -Path $target -Directory -Recurse | Sort-Object FullName -Descending foreach ($dir in $dirs) { if ($dir.Name -like *$old*) { $newName $dir.Name.Replace($old, $new) try { Rename-Item -Path $dir.FullName -NewName $newName -ErrorAction Stop Write-Host 已重命名: $($dir.FullName) - $newName } catch { Write-Warning 重命名失败: $($dir.FullName)原因: $($_.Exception.Message) } } }这里有几个细节值得借鉴Sort-Object FullName -Descending让深层目录排在前面类似 bat 中的sort /r。-ErrorAction Stop让重命名异常被捕获避免脚本中断。try/catch记录失败信息并继续处理后续目录。4.5 执行策略提示如果在 PowerShell 中运行脚本时报错“禁止运行脚本”那是因为默认执行策略限制。当前用户可以临时放开限制Set-ExecutionPolicy -Scope CurrentUser RemoteSigned也可以只对当前进程放开powershell -ExecutionPolicy Bypass -File .\rename.ps1需要提醒的是放开执行策略属于修改系统安全配置请务必在自己的电脑或获得授权的环境中操作并遵循最小权限原则。5. 方案三Python 脚本实现5.1 为什么还需要 Python既然 Windows 自带 PowerShell 也能实现为什么还要推荐 Python原因很简单当批量替换逻辑需要融入更大流程时Python 更合适。比如你需要先从 Excel 读取映射关系再根据映射批量替换文件夹名称或者需要记录完整的替换日志又或者需要同时处理文件夹和文件并过滤某些特殊目录。Python 的生态和代码表达力会让这类需求更易维护。5.2 基础版单层目录替换import os target_dir rD:\workspace\test old_str 2024 new_str 2025 for name in os.listdir(target_dir): full_path os.path.join(target_dir, name) if os.path.isdir(full_path) and old_str in name: new_name name.replace(old_str, new_str) new_path os.path.join(target_dir, new_name) os.rename(full_path, new_path) print(f已重命名: {name} - {new_name})这里需要注意os.listdir会同时返回文件和目录所以要用os.path.isdir过滤。name.replace(old_str, new_str)是字符串替换不会改变大小写也不会使用正则。如果替换后的new_name与现有目录重名os.rename在 Windows 下会报错建议提前检查。5.3 加入预览与冲突检查实际项目中最怕“直接执行后发现大批量改错”。所以更推荐带预览模式的脚本import os target_dir rD:\workspace\test old_str 2024 new_str 2025 preview True # 改为 False 时真正执行 rename_plan [] for name in os.listdir(target_dir): full_path os.path.join(target_dir, name) if os.path.isdir(full_path) and old_str in name: new_name name.replace(old_str, new_str) new_path os.path.join(target_dir, new_name) rename_plan.append((full_path, new_path)) # 检查重名冲突 conflict_items [item for item in rename_plan if os.path.exists(item[1]) and item[0] ! item[1]] if conflict_items: print(发现重名冲突请先处理) for _, new_path in conflict_items: print(f 目标已存在: {new_path}) exit(1) if preview: print(预览模式下以下目录将被重命名) for old_path, new_path in rename_plan: print(f {os.path.basename(old_path)} - {os.path.basename(new_path)}) print(f共 {len(rename_plan)} 个文件夹将被重命名) else: for old_path, new_path in rename_plan: os.rename(old_path, new_path) print(f已重命名: {os.path.basename(old_path)} - {os.path.basename(new_path)}) print(f完成共处理 {len(rename_plan)} 个文件夹)这种写法把“收集计划”和“执行计划”分离非常利于排查问题。执行前先preview True跑一遍确认结果无误后再改成False真正执行。5.4 递归处理所有子目录递归处理时要注意os.walk的一个特性在遍历过程中修改dirs列表可以控制后续进入哪些子目录但如果直接修改实际目录名可能会干扰os.walk的状态。更稳妥的做法是先收集所有需要重命名的目录再统一处理。为了保证子目录先于父目录可以按深度倒序排列。import os target_dir rD:\workspace\test old_str v1 new_str v2 dirs_to_rename [] for root, dirs, files in os.walk(target_dir): for name in dirs: if old_str in name: full_path os.path.join(root, name) new_path os.path.join(root, name.replace(old_str, new_str)) dirs_to_rename.append((full_path, new_path)) # 按路径层级倒序保证子目录优先被重命名 dirs_to_rename.sort(keylambda x: x[0].count(os.sep), reverseTrue) for old_path, new_path in dirs_to_rename: try: os.rename(old_path, new_path) print(f已重命名: {old_path} - {new_path}) except Exception as e: print(f重命名失败: {old_path}原因: {e})5.5 更安全的正则替换方式如果希望用正则表达式但又怕转义麻烦Python 的re.escape可以帮你自动转义关键字中的特殊字符import os import re target_dir rD:\workspace\test old_str 2024.01 new_str 2025-01 for name in os.listdir(target_dir): if os.path.isdir(os.path.join(target_dir, name)): new_name re.sub(re.escape(old_str), new_str, name) if new_name ! name: old_path os.path.join(target_dir, name) new_path os.path.join(target_dir, new_name) try: os.rename(old_path, new_path) print(f已重命名: {name} - {new_name}) except Exception as e: print(f重命名失败: {name}原因: {e})6. 实战按映射表批量替换多个关键字以上脚本都只替换一组关键字。但真实项目中经常需要一次处理多组映射比如把2024换成2025同时把v1换成v2、把dev换成test。在 Python 中可以用一个映射表实现import os target_dir rD:\workspace\test mappings { 2024: 2025, v1: v2, dev: test, } for name in os.listdir(target_dir): full_path os.path.join(target_dir, name) if not os.path.isdir(full_path): continue new_name name for old, new in mappings.items(): new_name new_name.replace(old, new) if new_name ! name: new_path os.path.join(target_dir, new_name) if os.path.exists(new_path): print(f跳过冲突: {name} - {new_name}目标已存在) continue os.rename(full_path, new_path) print(f已重命名: {name} - {new_name})这种方案的可维护性明显更好。后续如果映射关系变动只需要修改mappings字典不用改遍历逻辑。7. 常见问题与排查思路7.1 脚本运行后中文乱码问题现象常见原因解决思路bat 脚本中中文显示为乱码脚本文件编码不是 ANSI用记事本/编辑器另存为 ANSI 编码Python 打印中文乱码控制台编码不是 UTF-8在脚本开头加# -*- coding: utf-8 -*-或设置控制台代码页为 UTF-8PowerShell 输出中文乱码系统区域设置与脚本编码不一致保存.ps1文件时选择带 BOM 的 UTF-8 编码bat 乱码最典型。如果你保存为 UTF-8 编码中文关键字会变成乱码替换自然失败。建议把脚本中的关键字单独放到文件头部作为变量引用方便检查和修改。7.2 重命名失败提示找不到文件或路径这种情况多发生在递归重命名中。原因通常是脚本先重命名了父目录随后基于旧路径去重命名子目录导致路径失效。解决思路是按“子目录优先”的顺序处理也就是先重命名深度最大的目录。前面 Python 和 PowerShell 示例都已经考虑了这一点。7.3 替换后提示目标已存在这是最常见的冲突问题。可能原因两个文件夹替换后变成了同一个名称。目标名称在目标路径下已经存在。名称替换后包含非法字符例如\ / : * ? |。解决方案在执行前增加冲突检测。为冲突项自动添加序号如project-1、project-2。输出冲突清单由人工决定处理方式。7.4 提示拒绝访问原因是当前用户对目标目录没有写权限或者目录被某个程序占用。建议使用管理员权限运行脚本。关闭可能占用目录的程序例如资源管理器、编辑器、终端。检查目标目录是否在同步盘中。7.5 使用了特殊字符脚本执行结果不符合预期如果关键字中包含、%、^、.、等字符不同脚本的处理方式不同bat 中%和都需要特别注意建议在试运行前先echo出替换后的名称。PowerShell-replace会把关键字当作正则使用[regex]::Escape($old)可以避免。Python 使用replace()时是纯字符串替换不存在正则转义问题如果使用re.sub()记得用re.escape(old_str)。8. 最佳实践与工程建议8.1 永远先做预览无论使用哪种脚本第一次运行都应先输出“将要重命名的列表”而不是直接执行。这是文件目录操作类脚本最重要的一条原则。预览能帮你检查匹配范围是否合理有没有误匹配。替换后的名称是否符合预期。是否存在重名冲突。建议在写脚本时默认preview True确认无误后再手动改为执行模式。8.2 区分文件和目录很多批量重命名需求其实是文件和目录混合的。如果只打算替换文件夹名脚本就要加isdir判断如果文件夹和文件都要替换也需要分两个逻辑处理避免混淆。8.3 先备份再执行对于重要数据批量重命名前建议先做一次备份或者至少把当前目录列表导出成文件dir /b list_before.txt在 PowerShell 或 Python 中也可以把重命名计划输出为 CSV方便追溯。8.4 考虑大小写与隐藏目录批量替换默认区分大小写。如果你需要忽略大小写Python 中可以用re.sub(re.escape(old_str), new_str, name, flagsre.IGNORECASE)PowerShell 中可以用-ireplace。很多脚本默认不处理隐藏目录。若需要包含隐藏目录请检查脚本的遍历选项是否覆盖。8.5 脚本的可维护性工程化不是指写多复杂的代码而是让脚本在半年后仍然能看懂、敢运行。建议配置项放文件顶部集中管理。输出日志到文件方便事后排查。不要一次性把所有逻辑堆在一个循环里尽量把“收集计划”和“执行计划”分开。8.6 权限与安全问题重命名操作会影响目录结构请确保只有合法授权的人员执行。在生产环境或共享目录中批量重命名必须提前与相关团队确认并预留回滚方案。如果使用管理员权限运行脚本务必检查脚本内容来自可信来源避免执行不确定的代码。9. 总结与下一步学习建议本文围绕“一键批量替换文件夹名关键字”这个高频操作给出了三种完整的落地方案bat 脚本适合 Windows 单机快速处理但要注意编码和特殊字符。PowerShell 适合递归处理使用正则时记得处理转义。Python 脚本最灵活适合复杂映射、批处理集成和跨平台使用。你不需要一次性掌握全部三种方案完全可以按自己的使用习惯选择一套先跑通。建议你从 Python 预览版开始因为它提供了最安全的上手体验而且代码逻辑清晰方便后续改造。如果你在踩坑过程中发现新的报错场景或者有其他更高效的批量改名思路也欢迎在评论区分享。收藏本文备用下次需要批量处理目录名称时直接照着改关键变量就能跑。
一键批量替换文件夹名关键字：bat/PowerShell/Python三种方案
你是不是也遇到过这样的场景某个目录下面几十个文件夹名称里都带着同一个关键字需要全部替换掉。手动一个一个右键重命名不仅慢还容易出错如果目录层级再深一点那效率就更低了。本文将围绕“一键批量替换文件夹名关键字”这个需求给出多种可直接落地的解决方案覆盖 Windows 批处理、PowerShell、Python 三种方式并说明其中的核心原理、高频报错和工程化建议。无论你是刚接触脚本的新手还是日常需要处理文件整理的开发或运维同学都能从中找到一套适合自己的做法。1. 需求背景与适用场景1.1 这个需求解决什么问题批量替换文件夹名关键字本质上是一次“局部字符串替换”操作。前面说的“关键字”指的是文件夹名称中反复出现的一段文本比如某个版本号、日期、项目代号、渠道标记等等。常见的需求类型有一批文件夹名中包含“2024”需要统一替换为“2025”。下载的资源文件夹名带有推广后缀需要批量去掉。项目目录从“v1”变更为“v2”希望一次性改完。批量整理测试数据需要把目录中的某些标记改成统一规范。这类操作如果全手动完成最大的风险其实不是时间而是“漏改”和“误改”。手动操作时一旦文件夹数量多很容易在一个目录上重复确认或者不小心改了不该动的目录。用脚本批量处理只要规则定义清楚就能保证一次执行、结果一致。1.2 为什么需要多种实现方式很多教程只给一种做法但实际工程环境中不同人有不同的工具习惯和系统权限如果你的电脑是 Windows且只是偶尔处理一两次bat 脚本最方便不需要安装任何额外环境。如果目录层级复杂或者需要用到正则表达式PowerShell 是 Windows 自带的更强大选项。如果需要跨平台执行或者要对接后续的数据处理流程Python 脚本更加灵活。另外在实际项目中还经常会遇到需要“先看一遍替换结果确认无误再执行”的需求这时脚本里就需要加入预览模式。后面我会在每一种方案中体现这一点。2. 方案选型与前置知识2.1 三种脚本的定位对比方案适用系统需要安装易用程度适用场景bat 批处理Windows不需要最简单单层目录、临时处理、无 Python 环境PowerShellWindows系统自带中等多层目录、正则替换、权限控制PythonWindows / Linux / macOS需安装 Python灵活跨平台、复杂规则、需要集成到程序2.2 文件与文件夹重命名的底层逻辑在 Windows 系统中无论手动还是脚本重命名本质都是对文件系统的一项“目录项修改操作”。脚本方式之所以能批量处理是因为它可以循环遍历目录项逐一判断名称是否包含目标关键字然后调用系统 API 完成重命名。理解这一点对你排查问题很有帮助重命名并不是“复制粘贴”不会产生新的文件内容所以速度很快。如果目标文件夹已存在同名项目重命名会失败系统会提示冲突。如果文件夹正被某个程序占用重命名同样会失败。所以批量替换的核心流程就是遍历目录列表 - 判断名称是否包含关键字 - 构造新名称 - 检查冲突 - 执行重命名后面的脚本都遵循这个流程只是语法不同。2.3 关键字与通配符、正则表达式的区别先澄清一个容易混淆的概念这里的“关键字”不是编程语言中的关键字比如if、for而是一个普通字符串。在文件重命名场景中我们关心的是如何在字符串中定位并替换目标文本。不同脚本使用的匹配方式不同bat 中使用变量替换属于“纯字符串替换”。PowerShell 默认支持正则表达式因此需要留意特殊字符。Python 调用字符串的replace()方法时也是纯字符串替换如果使用re.sub()则支持正则。例如如果你想替换的关键字是2024.01在正则表达式中.是特殊符号表示“任意字符”直接使用正则替换会得到一个预料之外的结果。这个细节我会在第 4 节专门说明。3. 方案一bat 批处理脚本实现3.1 最简单的 bat 脚本先写一个最基础的版本适合处理单层目录下的文件夹重命名。echo off setlocal enabledelayedexpansion rem 在这里修改待替换和替换后的关键字 set old2024 set new2025 for /d %%d in (*) do ( set name%%d if not !name:%old%!!name! ( set newname!name:%old%%new%! ren %%d !newname! echo 已重命名: %%d --^ !newname! ) ) echo 批量替换完成。 pause把这 3 个核心点解释一下setlocal enabledelayedexpansion开启延迟变量扩展。因为我们在循环内部不断修改变量name和newname如果不开启延迟扩展!name!这种写法就不会得到预期的值。for /d %%d in (*)遍历当前目录下的所有目录名/d表示只匹配目录不处理文件。!name:%old%!去掉old后如果和原名称不同说明名称中确实包含关键字这比直接替换更安全可以避免不必要的重命名操作。运行方式把以上内容保存为rename.bat放到需要处理的目录下双击运行即可。3.2 支持指定路径的增强版上面的版本只能在当前目录下运行。实际使用中脚本往往放在任意位置需要处理的目标目录在其他路径。此时可以把目标路径作为一个变量传进来。echo off setlocal enabledelayedexpansion rem 目标路径请按需修改 set targetD:\workspace\test cd /d %target% set old2024 set new2025 for /d %%d in (*) do ( set name%%d if not !name:%old%!!name% ( set newname!name:%old%%new%! ren %%d !newname! echo 已重命名: %%d --^ !newname! ) ) echo 批量替换完成。 pause这段代码中cd /d %target%会切换到目标目录/d参数可以切换盘符。如果路径包含空格必须用引号包围否则命令会解析错误。3.3 bat 方案的核心局限bat 虽然方便但有两个关键坑编码问题。Windows 批处理默认使用 ANSI 编码中文环境为 GBK。如果你把上面的脚本保存为 UTF-8 编码中文关键字在运行时可能会乱码导致替换失败。建议在编辑器中另存为 ANSI 编码。特殊字符转义。如果关键字中包含、%、^等特殊字符批处理解析时可能出现意外行为需要额外转义。这种场景下我更推荐直接用 PowerShell 或 Python。3.4 bat 处理子目录中的文件夹严格来说for /d只能处理当前目录下的目录不会递归进入子目录。如果项目层级较多需要递归处理可以结合for /f和dir /ad /b /s实现echo off setlocal enabledelayedexpansion set targetD:\workspace\test set oldv1 set newv2 for /f delims %%d in (dir /ad /b /s %target% ^| sort /r) do ( set full%%d set name%%~nxd if not !name:%old%!!name! ( set newname!name:%old%%new%! set parent!full:\%name%! ren %%d !newname! echo 已重命名: %%d --^ !parent!\!newname! ) ) echo 批量替换完成。 pause这里使用sort /r的目的是让子目录优先于父目录被处理。因为如果先重命名父目录子目录路径就会发生变化基于旧路径的列表可能会失效。实际项目中递归处理文件夹时这个顺序问题很关键。4. 方案二PowerShell 脚本实现4.1 PowerShell 的优势PowerShell 是 Windows 自带的脚本环境相比 bat 拥有更强的字符串处理和对象管道能力。尤其适合以下场景需要递归处理。需要使用正则表达式做更灵活的匹配。希望重命名失败时能够捕获异常并继续处理。4.2 单层目录替换示例先看一个最简单的版本$old 2024 $new 2025 Get-ChildItem -Directory | Where-Object { $_.Name -like *$old* } | ForEach-Object { $newName $_.Name.Replace($old, $new) Rename-Item -Path $_.FullName -NewName $newName Write-Host 已重命名: $($_.Name) - $newName }说明Get-ChildItem -Directory只获取当前目录下的所有文件夹。Where-Object负责过滤名称中包含关键字的对象。$_.Name.Replace($old, $new)是 .NET 的字符串替换方法属于纯字符串替换不会把.当作正则符号。Rename-Item执行实际的重命名操作。在 PowerShell 中-like *$old*可以使用通配符但这里的*只是 PowerShell 的通配符与正则表达式无关。4.3 使用正则表达式替换如果希望支持更复杂的匹配规则可以使用-replace运算符$old 2024\. $new 2025- Get-ChildItem -Directory | Where-Object { $_.Name -match $old } | ForEach-Object { $newName $_.Name -replace $old, $new Rename-Item -Path $_.FullName -NewName $newName Write-Host 已重命名: $($_.Name) - $newName }注意$old中的\.是正则表达式写法表示匹配一个普通点号。如果直接用$_.Name.Replace($old, $new)则\.会按字面内容查找结果完全不一样。这一点非常容易踩坑。建议你在使用正则前先在 PowerShell 中测试匹配结果$testNames (2024.01, 202401, v2024.01) $testNames | ForEach-Object { if ($_ -match 2024\.) { Write-Host $_ 匹配成功 } else { Write-Host $_ 不匹配 } }4.4 递归处理子目录递归处理和 bat 类似同样需要考虑顺序。PowerShell 中可以直接使用Get-ChildItem -Directory -Recurse但要提醒一点直接遍历并重命名可能在处理到深层目录时触发路径失效问题。比较稳妥的做法是先收集目录列表再倒序处理$old v1 $new v2 $target D:\workspace\test $dirs Get-ChildItem -Path $target -Directory -Recurse | Sort-Object FullName -Descending foreach ($dir in $dirs) { if ($dir.Name -like *$old*) { $newName $dir.Name.Replace($old, $new) try { Rename-Item -Path $dir.FullName -NewName $newName -ErrorAction Stop Write-Host 已重命名: $($dir.FullName) - $newName } catch { Write-Warning 重命名失败: $($dir.FullName)原因: $($_.Exception.Message) } } }这里有几个细节值得借鉴Sort-Object FullName -Descending让深层目录排在前面类似 bat 中的sort /r。-ErrorAction Stop让重命名异常被捕获避免脚本中断。try/catch记录失败信息并继续处理后续目录。4.5 执行策略提示如果在 PowerShell 中运行脚本时报错“禁止运行脚本”那是因为默认执行策略限制。当前用户可以临时放开限制Set-ExecutionPolicy -Scope CurrentUser RemoteSigned也可以只对当前进程放开powershell -ExecutionPolicy Bypass -File .\rename.ps1需要提醒的是放开执行策略属于修改系统安全配置请务必在自己的电脑或获得授权的环境中操作并遵循最小权限原则。5. 方案三Python 脚本实现5.1 为什么还需要 Python既然 Windows 自带 PowerShell 也能实现为什么还要推荐 Python原因很简单当批量替换逻辑需要融入更大流程时Python 更合适。比如你需要先从 Excel 读取映射关系再根据映射批量替换文件夹名称或者需要记录完整的替换日志又或者需要同时处理文件夹和文件并过滤某些特殊目录。Python 的生态和代码表达力会让这类需求更易维护。5.2 基础版单层目录替换import os target_dir rD:\workspace\test old_str 2024 new_str 2025 for name in os.listdir(target_dir): full_path os.path.join(target_dir, name) if os.path.isdir(full_path) and old_str in name: new_name name.replace(old_str, new_str) new_path os.path.join(target_dir, new_name) os.rename(full_path, new_path) print(f已重命名: {name} - {new_name})这里需要注意os.listdir会同时返回文件和目录所以要用os.path.isdir过滤。name.replace(old_str, new_str)是字符串替换不会改变大小写也不会使用正则。如果替换后的new_name与现有目录重名os.rename在 Windows 下会报错建议提前检查。5.3 加入预览与冲突检查实际项目中最怕“直接执行后发现大批量改错”。所以更推荐带预览模式的脚本import os target_dir rD:\workspace\test old_str 2024 new_str 2025 preview True # 改为 False 时真正执行 rename_plan [] for name in os.listdir(target_dir): full_path os.path.join(target_dir, name) if os.path.isdir(full_path) and old_str in name: new_name name.replace(old_str, new_str) new_path os.path.join(target_dir, new_name) rename_plan.append((full_path, new_path)) # 检查重名冲突 conflict_items [item for item in rename_plan if os.path.exists(item[1]) and item[0] ! item[1]] if conflict_items: print(发现重名冲突请先处理) for _, new_path in conflict_items: print(f 目标已存在: {new_path}) exit(1) if preview: print(预览模式下以下目录将被重命名) for old_path, new_path in rename_plan: print(f {os.path.basename(old_path)} - {os.path.basename(new_path)}) print(f共 {len(rename_plan)} 个文件夹将被重命名) else: for old_path, new_path in rename_plan: os.rename(old_path, new_path) print(f已重命名: {os.path.basename(old_path)} - {os.path.basename(new_path)}) print(f完成共处理 {len(rename_plan)} 个文件夹)这种写法把“收集计划”和“执行计划”分离非常利于排查问题。执行前先preview True跑一遍确认结果无误后再改成False真正执行。5.4 递归处理所有子目录递归处理时要注意os.walk的一个特性在遍历过程中修改dirs列表可以控制后续进入哪些子目录但如果直接修改实际目录名可能会干扰os.walk的状态。更稳妥的做法是先收集所有需要重命名的目录再统一处理。为了保证子目录先于父目录可以按深度倒序排列。import os target_dir rD:\workspace\test old_str v1 new_str v2 dirs_to_rename [] for root, dirs, files in os.walk(target_dir): for name in dirs: if old_str in name: full_path os.path.join(root, name) new_path os.path.join(root, name.replace(old_str, new_str)) dirs_to_rename.append((full_path, new_path)) # 按路径层级倒序保证子目录优先被重命名 dirs_to_rename.sort(keylambda x: x[0].count(os.sep), reverseTrue) for old_path, new_path in dirs_to_rename: try: os.rename(old_path, new_path) print(f已重命名: {old_path} - {new_path}) except Exception as e: print(f重命名失败: {old_path}原因: {e})5.5 更安全的正则替换方式如果希望用正则表达式但又怕转义麻烦Python 的re.escape可以帮你自动转义关键字中的特殊字符import os import re target_dir rD:\workspace\test old_str 2024.01 new_str 2025-01 for name in os.listdir(target_dir): if os.path.isdir(os.path.join(target_dir, name)): new_name re.sub(re.escape(old_str), new_str, name) if new_name ! name: old_path os.path.join(target_dir, name) new_path os.path.join(target_dir, new_name) try: os.rename(old_path, new_path) print(f已重命名: {name} - {new_name}) except Exception as e: print(f重命名失败: {name}原因: {e})6. 实战按映射表批量替换多个关键字以上脚本都只替换一组关键字。但真实项目中经常需要一次处理多组映射比如把2024换成2025同时把v1换成v2、把dev换成test。在 Python 中可以用一个映射表实现import os target_dir rD:\workspace\test mappings { 2024: 2025, v1: v2, dev: test, } for name in os.listdir(target_dir): full_path os.path.join(target_dir, name) if not os.path.isdir(full_path): continue new_name name for old, new in mappings.items(): new_name new_name.replace(old, new) if new_name ! name: new_path os.path.join(target_dir, new_name) if os.path.exists(new_path): print(f跳过冲突: {name} - {new_name}目标已存在) continue os.rename(full_path, new_path) print(f已重命名: {name} - {new_name})这种方案的可维护性明显更好。后续如果映射关系变动只需要修改mappings字典不用改遍历逻辑。7. 常见问题与排查思路7.1 脚本运行后中文乱码问题现象常见原因解决思路bat 脚本中中文显示为乱码脚本文件编码不是 ANSI用记事本/编辑器另存为 ANSI 编码Python 打印中文乱码控制台编码不是 UTF-8在脚本开头加# -*- coding: utf-8 -*-或设置控制台代码页为 UTF-8PowerShell 输出中文乱码系统区域设置与脚本编码不一致保存.ps1文件时选择带 BOM 的 UTF-8 编码bat 乱码最典型。如果你保存为 UTF-8 编码中文关键字会变成乱码替换自然失败。建议把脚本中的关键字单独放到文件头部作为变量引用方便检查和修改。7.2 重命名失败提示找不到文件或路径这种情况多发生在递归重命名中。原因通常是脚本先重命名了父目录随后基于旧路径去重命名子目录导致路径失效。解决思路是按“子目录优先”的顺序处理也就是先重命名深度最大的目录。前面 Python 和 PowerShell 示例都已经考虑了这一点。7.3 替换后提示目标已存在这是最常见的冲突问题。可能原因两个文件夹替换后变成了同一个名称。目标名称在目标路径下已经存在。名称替换后包含非法字符例如\ / : * ? |。解决方案在执行前增加冲突检测。为冲突项自动添加序号如project-1、project-2。输出冲突清单由人工决定处理方式。7.4 提示拒绝访问原因是当前用户对目标目录没有写权限或者目录被某个程序占用。建议使用管理员权限运行脚本。关闭可能占用目录的程序例如资源管理器、编辑器、终端。检查目标目录是否在同步盘中。7.5 使用了特殊字符脚本执行结果不符合预期如果关键字中包含、%、^、.、等字符不同脚本的处理方式不同bat 中%和都需要特别注意建议在试运行前先echo出替换后的名称。PowerShell-replace会把关键字当作正则使用[regex]::Escape($old)可以避免。Python 使用replace()时是纯字符串替换不存在正则转义问题如果使用re.sub()记得用re.escape(old_str)。8. 最佳实践与工程建议8.1 永远先做预览无论使用哪种脚本第一次运行都应先输出“将要重命名的列表”而不是直接执行。这是文件目录操作类脚本最重要的一条原则。预览能帮你检查匹配范围是否合理有没有误匹配。替换后的名称是否符合预期。是否存在重名冲突。建议在写脚本时默认preview True确认无误后再手动改为执行模式。8.2 区分文件和目录很多批量重命名需求其实是文件和目录混合的。如果只打算替换文件夹名脚本就要加isdir判断如果文件夹和文件都要替换也需要分两个逻辑处理避免混淆。8.3 先备份再执行对于重要数据批量重命名前建议先做一次备份或者至少把当前目录列表导出成文件dir /b list_before.txt在 PowerShell 或 Python 中也可以把重命名计划输出为 CSV方便追溯。8.4 考虑大小写与隐藏目录批量替换默认区分大小写。如果你需要忽略大小写Python 中可以用re.sub(re.escape(old_str), new_str, name, flagsre.IGNORECASE)PowerShell 中可以用-ireplace。很多脚本默认不处理隐藏目录。若需要包含隐藏目录请检查脚本的遍历选项是否覆盖。8.5 脚本的可维护性工程化不是指写多复杂的代码而是让脚本在半年后仍然能看懂、敢运行。建议配置项放文件顶部集中管理。输出日志到文件方便事后排查。不要一次性把所有逻辑堆在一个循环里尽量把“收集计划”和“执行计划”分开。8.6 权限与安全问题重命名操作会影响目录结构请确保只有合法授权的人员执行。在生产环境或共享目录中批量重命名必须提前与相关团队确认并预留回滚方案。如果使用管理员权限运行脚本务必检查脚本内容来自可信来源避免执行不确定的代码。9. 总结与下一步学习建议本文围绕“一键批量替换文件夹名关键字”这个高频操作给出了三种完整的落地方案bat 脚本适合 Windows 单机快速处理但要注意编码和特殊字符。PowerShell 适合递归处理使用正则时记得处理转义。Python 脚本最灵活适合复杂映射、批处理集成和跨平台使用。你不需要一次性掌握全部三种方案完全可以按自己的使用习惯选择一套先跑通。建议你从 Python 预览版开始因为它提供了最安全的上手体验而且代码逻辑清晰方便后续改造。如果你在踩坑过程中发现新的报错场景或者有其他更高效的批量改名思路也欢迎在评论区分享。收藏本文备用下次需要批量处理目录名称时直接照着改关键变量就能跑。
