菩提风你电脑里是不是也有这么个目录：几年下来，几十个子文件夹层层嵌套，里面混着从邮件下载的、别人微信传的、扫描仪扫出来的PDF。领导一句“把合同都整理出来给我”，你打算挨个文件夹点进去翻？别，这活儿我真干过一次，两百多个PDF分散在四十多个子目录里，手动搞到半夜。后来写了个批处理，三秒钟全复制到一个文件夹里。从那天起，这类需求就再没上手累过。
这篇文章就是来解决“bat批处理，同目录文件夹下的pdf提取”这件事的。说得直白一点：把当前目录以及它下面所有子目录里的PDF文件，全部收集到同一个汇总文件夹。这里的“提取”指的是把PDF文件从杂乱的目录树里拣出来，不是从PDF内部抽文本、抽图片。那种内容解析要用Python之类的语言，拿bat干属于拿螺丝刀开啤酒瓶——能撬，但没必要。
适合看这篇的人：
- 手头有一堆散装PDF的办公族、资料管理员，甚至只是整理个人下载目录的人
- 完全没写过批处理的小白。这脚本不需要你会编程，会保存文本文件就行
- 已经会一点bat语法的人，可以跳过前两章，直接看第三章的for /r和延迟展开原理，以及第四章的进阶改造
先说清楚，脚本适用的是Windows系统，从Win7到Win11都能用，不需要装任何软件，系统自带的记事本就能写。
1. 第一版能跑的脚本：递归遍历并收集PDF
1.1 三分钟跑起来
使用步骤就三步：
- 在桌面新建一个文本文件，重命名为
收集PDF.bat。如果系统没显示扩展名，先到文件夹选项里把“隐藏已知文件类型的扩展名”关掉，否则你改出来的其实是收集PDF.bat.txt - 右键点这个文件，选“编辑”，把下面的脚本原样粘进去，保存
- 把这个bat文件放到你要整理的那个根目录下，双击运行
bat复制@echo off
setlocal enabledelayedexpansion
set "src=%~dp0"
set "dst=%~dp0PDF汇总"
set "count=0"
if not exist "!dst!" mkdir "!dst!"
for /r "!src!" %%f in (*.pdf *.PDF) do (
if /i not "%%~dpf"=="!dst!\" (
copy /y "%%f" "!dst!\" >nul 2>&1
set /a count+=1
echo [OK] %%f
)
)
echo.
echo 共收集 !count! 个 PDF 文件到 "!dst!"
pause
运行完，根目录下会多出一个PDF汇总文件夹，里面就是全盘扫描出来的PDF。脚本里*.pdf *.PDF两个通配符都写上是保险起见，Windows文件名本身不区分大小写，但加上不亏。
1.2 逐行拆解
从实用角度，你不需要懂每一行才能用，但搞清楚其中几行，后面改起来会顺手很多。
@echo off是让bat在执行时不回显命令本身，否则屏幕上会刷出一堆命令行原文，看着吓人。setlocal enabledelayedexpansion是启用变量延迟展开，这一行直接决定后面的计数器能不能正常累加，原因第二章详细说。
set "src=%~dp0"的意思是：把变量src的值设为当前bat文件所在的完整路径。%~dp0是批处理里最常用的魔法变量，展开后是“盘符:\路径\”这种带结尾斜杠的格式。~是去掉引号，d是盘符，p是路径。同理，set "dst=%~dp0PDF汇总"就是在bat所在目录下定义一个输出文件夹。
if not exist "!dst!" mkdir "!dst!"是经典的“没有才创建”判断。不提前判断直接mkdir也行，但会报“文件夹已存在”的错，虽然不影响结果，窗口里却多一条刺眼红字。
for /r "!src!" %%f in (*.pdf *.PDF) do (...)是整段脚本的灵魂。/r表示递归，也就是说从src开始，往下把每一层子目录都翻一遍，凡是符合括号里通配符的文件，就执行一次do后面的命令块。%%f是循环变量，每次循环都代表一个具体文件。注意批处理里循环变量要写两个百分号，在命令行直接敲则写一个。
循环体里if /i not "%%~dpf"=="!dst!\"的作用是跳过输出文件夹本身。%%~dpf展开成文件所在的完整路径（带结尾斜杠），如果它等于!dst!\，说明这个PDF已经在汇总文件夹里了，不能再参与复制，不然每跑一次脚本，汇总文件夹里的文件都要自己复制自己一轮。
copy /y "%%f" "!dst!\" >nul 2>&1是复制动作。/y表示目标存在时直接覆盖，不再弹窗问你。>nul 2>&1把复制过程里的正常信息和错误信息都丢进黑洞，屏幕上只保留你自己写的提示。set /a count+=1是计数器，每成功处理一个文件加一。
1.3 批处理路径扩展参数速查表
总记不住各种%~写法很正常，我给你列一张常用对照表，建议收藏：
| 写法 | 含义 | 示例（假设f是D:\资料\子目录\合同.pdf） |
|---|---|---|
| %~dp0 | 当前脚本所在路径 | D:\资料\ |
| %%~ff | 完整路径 | D:\资料\子目录\合同.pdf |
| %%~dpf | 文件所在盘符和路径 | D:\资料\子目录\ |
| %%~nf | 文件名，不含扩展名 | 合同 |
| %%~xf | 扩展名 | |
| %%~nxf | 文件名加扩展名 | 合同.pdf |
%~dp0后面的0代表第0个参数，也就是bat文件本身；如果是拖拽文件进来，%1就代表第一个被拖进来的文件夹或文件，这个在第四章讲“拖拽运行”时会用到。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 看懂批处理的关键：for /r、变量扩展与延迟展开
2.1 for /r到底怎么运转
很多人第一次写批处理，发现复制功能的脚本写不出来，根子就在搞不懂for /r。这东西其实不复杂，你把它理解成一个“文件夹遍历器”：从指定目录出发，先处理当前层，再下沉到第一个子目录，处理完一层接着往里钻，直到把所有层级的文件都过一遍。
for /r的语法：
bat复制for /r "起始目录" %%变量 in (文件匹配规则) do (命令)
注意三个细节。第一，起始目录必须用英文双引号包住，尤其是路径里有空格的时候，不包直接报错。第二，括号里的匹配规则支持*.pdf、*.pdf *.docx、报告*.pdf这类组合写法，多个匹配规则用空格隔开，符合任意一条的文件都会命中。第三，do后面的命令如果有多条，必须用一对圆括号包起来；跨行写没问题，但左括号必须跟do在同一行。
有个容易忽略的点：for /r对输出文件夹本身也会递归。只要PDF汇总在这个起始目录的辖区内，它就躲不掉被扫描的命。所以我在脚本里要么用判断跳过，要么用/XD参数排除（robocopy方案），二选一，但绝不能不做。
2.2 为什么计数器必须用!count!而不是%count%
这是新手问得最多的问题。有的人抄了脚本，把!count!改成%count%，然后发现屏幕上永远输出0，于是怀疑命令执行错了。这不能怪你，cmd的变量展开时机确实反直觉。
我写个小例子演示：
bat复制@echo off
set cnt=0
for %%f in (a.txt b.txt c.txt) do (
set /a cnt+=1
echo 第 %cnt% 个
)
这段代码运行后会输出“第 0 个”“第 0 个”“第 0 个”。原因在于，cmd在执行整个for块之前，会先把%cnt%替换成当前值。此时循环还没跑，cnt当然还是0。等循环体真正执行的时候，echo 第 %cnt% 个早就被替换成echo 第 0 个了，所以不管你累加多少次，它显示的永远是这一句话静态替换后的样子。
解决办法就是延迟展开。在脚本开头写setlocal enabledelayedexpansion，然后把循环体内要“动态读取”的变量写成!cnt!而不是%cnt%。感叹号形式的变量会等每次执行到那一行时才读取当前值，计数器这才起作用。
顺带说一句：%%f、%%~dpf、%%~nxf这些循环变量不受这个限制，每轮循环天然就是最新的值，因为它们本来就是在循环迭代时展开的。所以你会看到脚本里%%~dpf直接就用，不需要感叹号。
2.3 为什么加一个“别再复制自己”的判断
第一次写这个脚本，我压根没加跳过判断，结果跑完发现汇总文件夹里的PDF数量诡异变多。原因很简单：for /r "!src!"会遍历src下的所有子目录，而!dst!（PDF汇总文件夹）正好也在src下面。第一轮运行没问题，第二轮运行的时候，循环会把汇总文件夹里已有的PDF也当成扫描结果，复制一遍。文件确实不会变多，但每次都要浪费时间从头再拷一遍，而且在更复杂的脚本里还可能引发嵌套死循环。
我用的判断很朴素：
bat复制if /i not "%%~dpf"=="!dst!\" (
/i是不区分大小写，避免因为路径字母大小写不同而误判。%%~dpf得到的是带结尾反斜杠的完整路径，所以右边要写!dst!\，两边格式对齐才能比出正确结果。如果你的输出文件夹想改个名字，记得这一行也要同步改。
3. 三个进阶改造：清单、同名去重、保留结构
基础版能用了，但实际需求往往不止“复制”这一个动作。下面三个改造是我自己项目里被问得最多的，按需求频次排序。
3.1 只生成PDF清单，不实际复制
有时候你只是想盘点一下有哪些PDF，不想真去拷贝几百兆文件。这时候把copy换成“写清单”就行。用一条dir命令就够：
bat复制@echo off
cd /d "%~dp0"
dir /s /b *.pdf > PDF清单.txt
for /f "delims=" %%i in ('type PDF清单.txt ^| find /c /v ""') do set cnt=%%i
echo 共 %cnt% 个 PDF，清单已生成：PDF清单.txt
pause
这里dir /s /b的作用是列出所有符合*.pdf的完整路径，> PDF清单.txt把结果写进文本文件。统计行数用管道配合find /c /v ""——find /c统计行数，/v ""表示匹配所有非空行，连起来就是数一下文件里有几行。注意管道符|在for命令里要写成^|转义，否则cmd会理解错位置。
生成的清单每一行都是一个PDF的完整路径，可以直接发给同事核对，也可以作为交接文档用，比口头说“在第几个文件夹里”高效得多。
3.2 同名文件不覆盖：保留第一次出现的版本
基础版脚本有一个隐藏坑：如果子目录A里有个合同.pdf，子目录B里也正好有个合同.pdf，第二次复制到汇总文件夹时会覆盖第一次的。别问我是怎么发现的，交上去的合同变成同一份，差点出事。
要解决，加一个存在性判断就行：
bat复制@echo off
setlocal enabledelayedexpansion
set "src=%~dp0"
set "dst=%~dp0PDF汇总"
if not exist "!dst!" mkdir "!dst!"
for /r "!src!" %%f in (*.pdf *.PDF) do (
if /i not "%%~dpf"=="!dst!\" (
if not exist "!dst!\%%~nxf" (
copy /y "%%f" "!dst!\" >nul 2>&1
echo [保留] %%f
) else (
echo [跳过] 同名：%%~nxf 来源：%%f
)
)
)
pause
if not exist "!dst!\%%~nxf"检查汇总文件里有没有同名的。没有就复制，有就跳过并把来源打印出来，便于你事后决定是保留哪一份还是手动改个名字。这里有个细节：%%~nxf是文件名加扩展名，!dst!\%%~nxf拼成完整目标路径，因为循环变量不受延迟展开影响，这个判断每一轮都能拿到正确文件名。
3.3 收集完顺手重命名：配合ren做序列编号
整理资料时，文件名乱比没有文件名更头疼。收集完之后想统一成PDF_001.pdf这种格式，批处理做起来也不难。在上一版脚本后面追加一段：
bat复制set /a n=1
for %%f in ("!dst!\*.pdf") do (
ren "%%f" "PDF_!n!.pdf"
set /a n+=1
)
注意ren重命名时，第一个参数是旧文件，第二个是新文件名，不写路径时默认在当前目录操作。这里循环变量%%f拿到的是带完整路径的文件名，ren会直接改文件，不需要cd进目录。!n!会从1一直递增，格式可以通过set "m=00!n!"再取末尾三位来补零，我就不展开写了，用到再说。
3.4 保留原始目录结构的收集方式
上面几个版本都是“拍平”，所有PDF拉到一个平面文件夹里。但如果你的资料层级是有意义的——比如按项目、按年份分得很清楚——拍平之后反而找不到对应关系。这时直接用robocopy最省事：
bat复制@echo off
robocopy "%~dp0" "%~dp0PDF汇总" *.pdf /S /XD "%~dp0PDF汇总"
pause
robocopy是Windows自带的文件复制工具，比copy健壮很多。/S表示复制子目录中非空的文件夹，/XD是排除指定目录，把输出文件夹排除掉避免他把自己也复制一遍。运行完，PDF汇总下面会和原目录保持同样的层级结构，每个子文件夹里放着对应的PDF。
顺带一提，robocopy的退出码是0到7之间的数字，0到7都算成功，8以上才是错误。普通批处理里用if %errorlevel% geq 8 exit /b 1判断一下即可，不用深究，知道有这回事就行。
4. 实战踩坑记录与调试三板斧
写批处理，跑通只是开始，真正让你薅头发的是各种环境差异。下面几个坑我全踩过，写出来帮你省点时间。
4.1 中文乱码问题
脚本里带中文，保存编码不对就会乱码。Windows的cmd默认代码页是936（GBK），如果你用UTF-8编码保存bat，运行到中文echo时基本必乱。
两个解法，二选一：
- 最简单的做法：记事本另存为时，编码选“ANSI”，和系统代码页对应，中文通常不会乱
- 如果你的脚本要给别人跨机器用，且可能有繁体中文环境，建议在开头加一行
chcp 65001 >nul，同时把文件保存为UTF-8编码
我个人习惯用ANSI保存，省心。但要注意：一旦用了chcp 65001切到UTF-8，文件本身必须是UTF-8编码，否则更乱。这个顺序别搞反。
4.2 路径带空格，引号必须成对
Windows很多用户文件夹是C:\Users\张三\Desktop这种带中文和空格的路径。脚本里我写的一律带英文双引号，这是安全的。但自己改动时很容易漏，比如set "dst=%~dp0PDF汇总"如果写成set dst=%~dp0PDF汇总，当路径里有空格时，变量只截取到空格之前，后面全丢。
调试时不管什么问题，先检查所有路径赋值和命令引用是不是都加了引号。80%的“找不到文件”错误都是这个引起的。
4.3 双击闪退，看不到报错
bat运行出错时窗口会瞬间关闭，你根本来不及看提示。这时候不要双击，改成在命令行里手动执行：
- 按
Win + R，输入cmd回车 - 把bat文件直接拖进黑色窗口，回车
这样报错信息会留在窗口里。还有一种更快的临时调试法：在脚本开头把@echo off改成@echo on，或者直接删掉这行，让cmd把每一条命令都打出来，很容易定位是哪一行出问题。
4.4 让脚本更像工具的四个小惯用操作
基础功能稳定之后，我建议给脚本做几个“人体工学”改造：
- 拖拽指定文件夹：脚本开头加一段
bat复制if "%~1"=="" (
set "src=%~dp0"
) else (
set "src=%~1"
)
这样你只要把一个文件夹拖到bat图标上，它就对那个文件夹生效，不用来回移动脚本文件。
-
把快捷方式放到右键“发送到”菜单：按
Win + R输入shell:sendto回车，把你写好的bat快捷方式放进去。以后在任意文件夹里选中文件，右键“发送到”一下，就能触发整理。 -
开机自动运行：按
Win + R输入shell:startup回车，把bat的快捷方式扔进去。不过批处理做开机自启要小心，别放跟网络、服务相关的脚本，纯粹做文件整理倒是没问题。 -
打包成exe：发给不懂技术的同事时，别直接发bat源码，右键编辑容易被改坏。可以用现成的bat转exe工具打包成独立程序，双击就能用。
5. 几个能直接“抄作业”的完整脚本变体
最后分享几个我实际用过的完整版本，各自适合不同场景。
场景一：只想把子文件夹里的PDF全部复制到一个地方，适合文件量少、不担心同名的情况。
bat复制@echo off
setlocal enabledelayedexpansion
set "dst=%~dp0PDF汇总"
if not exist "!dst!" mkdir "!dst!"
for /r "%~dp0" %%f in (*.pdf) do (
copy /y "%%f" "!dst!\" >nul 2>&1
)
echo 收集完成。
pause
场景二：同名文件自动加上序号，不覆盖任何现有文件，适合合同、发票这类容易重名的资料。
bat复制@echo off
setlocal enabledelayedexpansion
set "dst=%~dp0PDF汇总"
if not exist "!dst!" mkdir "!dst!"
set "idx=1"
for /r "%~dp0" %%f in (*.pdf) do (
if not exist "!dst!\%%~nxf" (
copy /y "%%f" "!dst!\" >nul 2>&1
) else (
set "name=%%~nf_!idx!%%~xf"
copy /y "%%f" "!dst!\!name!" >nul 2>&1
set /a idx+=1
)
)
echo 完成，有同名文件已加序号。
pause
场景三：一边收集一边输出清单，最终生成一份带完整来源路径的汇总，资料盘点时特别好用。
bat复制@echo off
setlocal enabledelayedexpansion
set "dst=%~dp0PDF汇总"
if not exist "!dst!" mkdir "!dst!"
set "log=%~dp0PDF收集清单.txt"
if exist "!log!" del "!log!"
for /r "%~dp0" %%f in (*.pdf) do (
if /i not "%%~dpf"=="!dst!\" (
copy /y "%%f" "!dst!\" >nul 2>&1
echo %%f>>"!log!"
)
)
echo 文件已收集，来源清单：!log!
pause
echo %%f>>"!log!"这里有个细节，>和>>前面如果紧跟变量，容易把变量名的最后一个字符吞掉，写成%%f>>没问题，但写成%%f >>会因为空格问题改变行为，我自己就栽过一次。
说实话，批处理在国内职场里被低估了。很多人觉得它“老古董”，遇到文件整理第一反应是找软件、找脚本工具，其实系统自带的能力早就够用。这套PDF提取脚本我从第一次写完到现在，前前后后改了五六版，每次都是在真实需求里发现新问题——同名覆盖、编码乱码、目录递归死循环——然后一点点补丁打上去。希望你拿过去用的时候，能直接站在一个已经踩过坑的版本上，少走这几段弯路。