批处理脚本递归替换文件名短横线为下划线出现语法错误求助

这个问题我碰到过！你用For /R直接替换的时候出错，核心原因是没搞清楚For /R返回的是完整路径文件名，而你原脚本的逻辑是针对当前目录下的文件名（不含路径）来处理的，直接套用就会出问题，具体来说：

为什么原递归写法会报错？ #

1. For /R %%a in (*)会返回文件的完整绝对路径（比如C:\test\sub-folder\file-name.txt），你原脚本里Set "File=%%~a"会把整个路径+文件名赋值给变量，替换时会把路径里的-也替换掉（比如把sub-folder改成sub_folder），这显然不是你想要的。
2. 更关键的是，Ren命令如果接收的目标参数包含路径，会触发语法错误——Ren的第二个参数应该是新文件名（不需要路径，因为它默认在原文件的目录下操作），而你替换后的变量会带路径，导致命令执行失败。

正确的递归处理脚本 #

下面是修正后的脚本，专门针对递归场景处理，只修改文件名部分的-：

@echo off
Setlocal enabledelayedexpansion
Set "Pattern=-"
Set "Replace=_"

:: 递归遍历当前目录及所有子目录下的所有文件
For /R %%a in (*) Do (
    :: 分离文件的路径、纯文件名（不含扩展名）、扩展名
    Set "FileDir=%%~dpa"
    Set "RawFileName=%%~na"
    Set "FileExt=%%~xa"
    
    :: 只对纯文件名部分进行替换操作
    Set "NewRawFileName=!RawFileName:%Pattern%=%Replace%!"
    
    :: 执行重命名：原文件完整路径 + 新文件名+扩展名
    Ren "%%a" "!NewRawFileName!!FileExt!"
)
Pause&Exit

脚本关键部分解释 #

• %%~dpa：提取%%a对应的文件所在的完整路径（比如C:\test\sub-folder\），我们不需要修改它，只是用来确认文件位置。
• %%~na：提取文件的纯文件名（不含路径和扩展名，比如file-name），这才是我们需要替换的目标部分。
• %%~xa：提取文件的扩展名（比如.txt），保留原扩展名不修改。
• 延迟扩展!RawFileName:%Pattern%=%Replace%!：确保在循环中能正确替换变量内容，这部分和你原脚本的逻辑一致，但只作用于纯文件名。

额外注意事项 #

• 如果你的文件名里包含!，延迟扩展会导致字符丢失，这时候需要临时关闭延迟扩展来处理，不过一般场景下这个脚本足够用了。
• 执行脚本前建议先测试：把Ren改成Echo Ren，这样会打印出要执行的重命名命令，确认没问题后再去掉Echo。

内容的提问来源于stack exchange，提问作者user3614293