Windows批处理脚本批量修改文件名前缀失效问题排查

以下是一款用于Windows系统批量修改文件及目录前缀的批处理脚本，预期功能是提示用户输入旧前缀与新前缀，将所有以旧前缀开头的文件/目录替换为新前缀（例如旧前缀"abc"、新前缀"xyz"时，"abcdeabc.txt"会变为"xyzdeabc.txt"），但实际运行时未修改任何文件便直接退出：

@echo off
setlocal enabledelayedexpansion

set "OLD_PREFIX="
set /p "OLD_PREFIX=Enter the old prefix: "

set "NEW_PREFIX="
set /p "NEW_PREFIX=Enter the new prefix: "

set found_files=0
set found_dirs=0

for /f "delims=" %%F in ('dir /b /a-d %OLD_PREFIX%*') do (
    set "FILENAME=%%F"
    if "!FILENAME:~0,^%OLD_PREFIX:^=^%!=="%OLD_PREFIX%" (
        set "NEW_FILENAME=%NEW_PREFIX%!FILENAME:~%OLD_PREFIX:~0,-1%!"
        ren "%%F" "!NEW_FILENAME!"
        set /a found_files+=1
    )
)

for /d %%D in (%OLD_PREFIX%*) do (
    set "DIRNAME=%%D"
    if "!DIRNAME:~0,^%OLD_PREFIX:^=^%!=="%OLD_PREFIX%" (
        set "NEW_DIRNAME=%NEW_PREFIX%!DIRNAME:~%OLD_PREFIX:~0,-1%!"
        ren "%%D" "!NEW_DIRNAME!"
        set /a found_dirs+=1
    )
)

echo %found_files% file(s) renamed.
echo %found_dirs% directory(ies) renamed.

pause

错误原因分析 #

1. 前缀长度计算语法完全错误：原脚本中!FILENAME:~0,^%OLD_PREFIX:^=^%!的写法无法正确获取旧前缀的字符长度，导致if判断永远不成立，直接跳过所有重命名操作。
2. 字符串截取起始位置错误：!FILENAME:~%OLD_PREFIX:~0,-1%!是取旧前缀去掉最后一个字符的长度作为起始位置，既不符合需求，也会导致截取内容异常。
3. 变量引用逻辑冲突：混合使用%变量%和!变量!的引用方式，导致延迟扩展与即时扩展的解析时机混乱，匹配逻辑失效。

修正后的脚本 #

@echo off
setlocal enabledelayedexpansion

set "OLD_PREFIX="
set /p "OLD_PREFIX=Enter the old prefix: "

set "NEW_PREFIX="
set /p "NEW_PREFIX=Enter the new prefix: "

:: 计算旧前缀的字符长度
set "strlen_old=0"
:strlen_loop
if not "!OLD_PREFIX:~%strlen_old%!"=="" (
    set /a strlen_old+=1
    goto strlen_loop
)

set found_files=0
set found_dirs=0

:: 处理文件
for /f "delims=" %%F in ('dir /b /a-d "!OLD_PREFIX!*" 2^>nul') do (
    set "FILENAME=%%F"
    :: 校验文件名前缀是否匹配
    if "!FILENAME:~0,%strlen_old%!"=="!OLD_PREFIX!" (
        :: 从旧前缀长度位置截取剩余内容，拼接新前缀
        set "NEW_FILENAME=!NEW_PREFIX!!FILENAME:~%strlen_old%!"
        ren "%%F" "!NEW_FILENAME!"
        set /a found_files+=1
    )
)

:: 处理目录
for /d %%D in ("!OLD_PREFIX!*") do (
    set "DIRNAME=%%D"
    if "!DIRNAME:~0,%strlen_old%!"=="!OLD_PREFIX!" (
        set "NEW_DIRNAME=!NEW_PREFIX!!DIRNAME:~%strlen_old%!"
        ren "%%D" "!NEW_DIRNAME!"
        set /a found_dirs+=1
    )
)

echo !found_files! file(s) renamed.
echo !found_dirs! directory(ies) renamed.

pause
endlocal

修正说明 #

• 新增前缀长度计算逻辑：通过循环准确获取旧前缀的字符长度，为后续截取提供正确依据。
• 修正字符串截取逻辑：使用计算好的长度作为起始位置，完整保留旧前缀之后的内容，确保重命名结果符合预期。
• 统一使用延迟扩展变量（!变量!）：避免变量解析时机冲突，确保判断和赋值逻辑正确执行。
• 添加2^>nul：屏蔽无匹配文件时dir命令的错误输出，优化脚本运行体验。
• 输出部分改用延迟扩展变量：确保循环中修改的计数变量能正确显示最终结果。

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