批处理遍历含特殊字符文件名调用FFmpeg转码时报错如何解决

报错根因 #

你遇到的) was unexpected at this time报错由三个核心问题导致：

• 你在for /f的括号代码块内大量使用goto跳转，会打断CMD对代码块的预解析逻辑，当文件名包含括号、&等特殊语法字符时，CMD会误将文件名里的符号当成代码块的闭合标记，抛出语法错误
• 文件名的引号包裹不规范："%%~ni".jpg这种写法没有把完整文件名放在引号内，特殊字符还是会暴露在语法解析环境中；输出路径多余的反斜杠也可能导致解析异常
• for /f 没有加usebackq参数，dir /b输出的含特殊字符的文件名会被当成命令片段解析

修复后完整脚本 #

@echo off
setlocal EnableDelayedExpansion
:: 先判断输出目录是否存在，不存在则创建
if not exist "..\output" md "..\output"
set "FFMPEG=C:\ffmpeg\bin\ffmpeg.exe"
:: 加usebackq避免文件名被当成命令解析，delims=保留完整文件名，/a-d只遍历文件不遍历文件夹
for /f "usebackq delims=" %%i in (`dir /b /a-d`) do (
    set "skip=0"
    :: 跳过脚本自身
    if /i "%%~nxi"=="convert.cmd" set "skip=1"
    :: 跳过图片文件
    if /i "%%~xi"==".jpg" set "skip=1"
    if /i "%%~xi"==".webp" set "skip=1"
    :: 跳过已经是mp3的文件
    if /i "%%~xi"==".mp3" set "skip=1"
    
    if "!skip!"=="1" (
        echo 跳过文件：%%~nxi
        goto continue
    )

    :: 判断是否存在同名jpg封面
    if exist "%%~ni.jpg" (
        "%FFMPEG%" -i "%%i" -i "%%~ni.jpg" -y -map_metadata 0 -map 0 -map 1 -movflags use_metadata_tags -vcodec jpeg2000 -acodec libmp3lame "..\output\%%~ni.mp3"
        del /q "%%~ni.jpg"
        del /q "%%i"
        goto continue
    )

    :: 判断是否存在同名webp封面
    if exist "%%~ni.webp" (
        "%FFMPEG%" -i "%%i" -i "%%~ni.webp" -y -map_metadata 0 -map 0 -map 1 -movflags use_metadata_tags -vcodec jpeg2000 -acodec libmp3lame "..\output\%%~ni.mp3"
        del /q "%%~ni.webp"
        del /q "%%i"
        goto continue
    )

    :: 无封面的情况
    "%FFMPEG%" -i "%%i" -y -map_metadata 0 -map 0 -movflags use_metadata_tags -vcodec jpeg2000 -acodec libmp3lame "..\output\%%~ni.mp3"
    del /q "%%i"

    :continue
)
endlocal
echo 全部转码完成
pause

关键修改说明 #

• 新增usebackq参数到for /f，用反引号包裹dir /b命令，避免文件名中的特殊字符被CMD当成命令片段解析
• 所有涉及文件名、路径的位置，都把完整路径/文件名包裹在双引号内，避免特殊字符暴露
• 先通过标记变量skip判断是否需要跳过当前文件，减少不必要的goto跳转，降低代码块解析异常概率
• 新增输出目录自动创建逻辑，避免输出目录不存在导致的报错
• 给del命令加/q参数，删除文件时不需要确认，避免批量处理时卡住
• 后缀判断加/i参数，忽略大小写，避免.JPG/.MP3这类大写后缀的文件被误处理

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