参数和退出码是两件事,但经常一起出现:脚本从命令行拿输入,跑完再把结果告诉调用方。这篇把两头都跑一遍,测试目录 E:\cmd-demo\args,脚本由同目录的 setup.ps1 生成,代码页 936。

位置参数只认顺序,引号会留在值里

E:\cmd-demo\args>show-args.bat a b "c d"
0=show-args.bat
1=[a]
2=[b]
3=["c d"]
4=[]
*=[a b "c d"]

方括号是我在脚本里加的,只为了看清空值。三件事:

  • %0 是脚本本身,从 %1 起才是参数。
  • %3 收到的不是 c d,而是带引号的 "c d"。cmd 只按空格切分,引号用来阻止切分,不会从值里消失。
  • %4 没传,展开成空字符串,echo 不报错。

%* 是整条参数区的原文,切分和引号都按调用时的样子保留。

传一个带空格的路径,差别更直接:

E:\cmd-demo\args>show-args.bat "E:\cmd-demo\args\data dir\sample report.txt"
1=["E:\cmd-demo\args\data dir\sample report.txt"]
2=[]

不加引号时,cmd 按空格切成三段:

E:\cmd-demo\args>show-args.bat E:\cmd-demo\args\data dir\sample report.txt
1=[E:\cmd-demo\args\data]
2=[dir\sample]
3=[report.txt]
*=[E:\cmd-demo\args\data dir\sample report.txt]

%1 到 %3 全错,%* 却还是完整原文,因为它是原始命令行,不参与切分。脚本里只要把参数当路径用,调用时就必须加引号。

不止空格,&、|、> 这些字符在 cmd 眼里是命令分隔符,不套引号时参数会在半路被截断:

E:\cmd-demo\args>show-args.bat "a&b"
1=["a&b"]

E:\cmd-demo\args>show-args.bat a&b
1=[a]
'b' 不是内部或外部命令,也不是可运行的程序
或批处理文件。

第二条把 b 当成了新命令,退出码 1。凡是参数可能来自用户输入或路径,统一加引号最省事。

%9 之后没有 %10。写 %10,cmd 认成 %1 再接一个字面字符 0:

E:\cmd-demo\args>ten-args.bat a b c d e f g h i j k
1=a
2=b
10=a0
*=a b c d e f g h i j k

要处理第十个以后的参数,只有 shift 一条路。

截图

缺参数时,if %1== 会让脚本直接停

E:\cmd-demo\args>bad-check.bat
此时不应有 echo。

这句话走的是 stderr(截图里是红色),退出码 255,脚本里后面的 echo 检查结束 也没有执行。实际展开成 if ==admin echo 管理员,比较符两边都空了,cmd 在解析阶段就报错,整个脚本中止,不是「条件不成立、继续往下跑」。

带引号的写法也会坏,只是坏法不同:

E:\cmd-demo\args>bad-quote.bat "a b"
此时不应有 b""==""。

%1 本身带引号,套进 if "%1"=="" 变成 if ""a b""=="",引号配对乱了。

正确写法是先用 %~1 去掉引号,再整体加引号比较:

if "%~1"=="" (
  echo 缺少参数:用法 need-arg.bat ^<名字^>
  exit /b 2
)
E:\cmd-demo\args>need-arg.bat
缺少参数:用法 need-arg.bat <名字>

E:\cmd-demo\args>need-arg.bat 张三
收到参数:张三

第一条的退出码是 2(截图下方列了每条的退出码)。判断参数是否为空,统一用 if "%~1"=="",不要用 if %1==,也不要用 if "%1"==""。

截图

%~1 去掉引号,还能把路径拆开

E:\cmd-demo\args>path-args.bat "E:\cmd-demo\args\data dir\sample report.txt"
raw1  =["E:\cmd-demo\args\data dir\sample report.txt"]
tilde1=[E:\cmd-demo\args\data dir\sample report.txt]
f1    =[E:\cmd-demo\args\data dir\sample report.txt]
d1    =[E:]
p1    =[\cmd-demo\args\data dir\]
n1    =[sample report]
x1    =[.txt]
nx1   =[sample report.txt]
dp1   =[E:\cmd-demo\args\data dir\]
z1    =[7]
t1    =[2026/11/20 14:40]
a1    =[--a--------]
  • ~ 去掉外层引号,最常用。
  • f 完整路径,d 盘符,p 路径(末尾带反斜杠),n 文件名,x 扩展名,nx 文件名加扩展名,dp 盘符加路径。
  • z 字节数,t 修改时间,a 属性。--a-------- 里的 a 是归档属性,横线表示其余位没有。
  • 这些修饰符只对 %1 这种位置参数生效。%* 没有对应写法,写成 %~* 会报「路径运算符的下列用法无效」并中止,退出码 255。

路径类和属性类的行为并不一样。传一个不存在的文件:

E:\cmd-demo\args>path-args.bat E:\cmd-demo\args\nope.txt
f1    =[E:\cmd-demo\args\nope.txt]
n1    =[nope]
x1    =[.txt]
z1    =[]
t1    =[]
a1    =[]

~f、~n、~x 只是对字符串做拆分,文件不存在照样有值;~z、~t、~a 要读文件属性,拿不到就是空。所以不能用 %~z1 是否为空来判断参数有没有传,判断参数用 if "%~1"==""。

截图

shift 挪的是 %1 到 %9,%* 不动

E:\cmd-demo\args>shift-demo.bat alpha beta gamma
初始: 1=alpha 2=beta 3=gamma *=alpha beta gamma
一次: 1=beta 2=gamma 3= *=alpha beta gamma
两次: 1=gamma 2= 3= *=alpha beta gamma

每 shift 一次,%2 的值进 %1,原来的 %1 被丢掉,后面依次前移;%* 始终是原始整串。这一点和直觉相反,实测如此,所以遍历时不要同时依赖 %*。

遍历参数用 goto 循环:

setlocal enabledelayedexpansion
set n=0

:loop
if "%~1"=="" goto done
set /a n+=1
echo 第 !n! 个: %1
shift
goto loop

:done
echo 共 !n! 个参数
E:\cmd-demo\args>loop-args.bat 甲 "乙 丙" 丁
第 1 个: 甲
第 2 个: "乙 丙"
第 3 个: 丁
共 3 个参数
甲 "乙 丙" 丁 仍是全部参数

带空格的参数是一个整体,但引号还在。要输出干净的值,把 %1 换成 %~1。shift 移到最后 %~1 为空,循环结束,这也是前面坚持用 "%~1"=="" 判断的原因。

脚本里数数用了 !n!,因为 set /a 和 echo 在同一段循环里,%n% 会停在进入循环前的值。

截图

if errorlevel N 判断的是「大于等于 N」

E:\cmd-demo\args>if-errorlevel.bat
errorlevel=2
if errorlevel 1 = 真
if errorlevel 2 = 真
百分号等于 2 = 真
成功时 if errorlevel 0 也为真

退出码是 2 时,if errorlevel 1 和 if errorlevel 2 都成立,if errorlevel 3 不成立。它问的是「有没有达到 N」,不是「是不是正好 N」。要判断精确值,写 if %errorlevel%==2。

if errorlevel 0 在成功时也成立,因为 0 大于等于 0。所以 if errorlevel 0 echo 成功 永远会打印,这句没有判断作用,判断成功应当用 if not errorlevel 1。

截图

括号块里,%errorlevel% 是块开始前的值

E:\cmd-demo\args>if-errorlevel-block.bat
ok 百分号=0
ok 感叹号=0
fail 百分号=0
fail 感叹号=5
fail if errorlevel 1 = 真

循环体是一个括号块,cmd 在执行之前就把块里的 %errorlevel% 全部替换成解析时的值(这里是 0),所以两次都打印 0。开了 setlocal enabledelayedexpansion 后,!errorlevel! 到执行那一行才取值,第二次才是 5。

if errorlevel 1 不需要感叹号,它不是变量展开,执行时直接读当前退出码。规则可以记成:要打印或参与字符串比较,用 !errorlevel!;要分支,if errorlevel 本身够用。

还有个更隐蔽的坑:

E:\cmd-demo\args>shadow-errorlevel.bat
变量 errorlevel=0
if errorlevel 5 = 真

脚本里写了 set errorlevel=0,cmd 会认为你定义了一个普通变量,%errorlevel% 从此读这个变量,永远 0;但 if errorlevel 读的是进程真实退出码,仍然正确。不要拿 errorlevel 当变量名,一旦有人这么写,排查会很费时间。

截图

exit /b 只退一层,exit 把整个 cmd 结束掉

E:\cmd-demo\args>exit-b-demo.bat
主流程开始
进入 sub
sub 返回后 errorlevel=3
主流程继续

:sub 里的 exit /b 3 只结束子过程,回到 call 的下一行,errorlevel 变成 3,主流程继续,最后 exit /b 7 把 7 交给调用方。

把那个 exit /b 3 换成 exit 5,行为完全不同:

E:\cmd-demo\args>exit-all-demo.bat
主流程开始
进入 sub

E:\cmd-demo\args>caller-after.bat
主流程开始
进入 sub

caller-after.bat 里写的是 call exit-all-demo.bat & echo 调用方这一行,那行 echo 没有出现。exit 结束的是整个 cmd 进程,不只是被调用的脚本,& 后面的命令和调用方脚本的剩余部分一起没了。区别不在「退出码传不传」,而在「退几层」。

exit /b 不带参数还有一个实测差异。exit-b-noparam.bat 先执行 cmd /c exit 9,再 exit /b;exit-b-noparam-sub.bat 把这两行放进 :sub,由主流程 call 它:

E:\cmd-demo\args>exit-b-noparam.bat
before=9

E:\cmd-demo\args>exit-b-noparam-sub.bat
after=9

第一个脚本里 %errorlevel% 已经是 9,进程最终却返回 0;第二个脚本在 call :sub 之后读到的仍是 9。与其记这个差异,不如始终写明确的数字,或者 exit /b %errorlevel%。

截图

调用方取退出码,别写在同一行

E:\cmd-demo\args>same-line.bat
主流程开始
进入 sub
sub 返回后 errorlevel=3
主流程继续
同一行 errorlevel=0

E:\cmd-demo\args>next-line.bat
主流程开始
进入 sub
sub 返回后 errorlevel=3
主流程继续
下一行 errorlevel=7
下一行 if errorlevel 7 = 真

same-line.bat 里是 call exit-b-demo.bat & echo 同一行 errorlevel=%errorlevel%。%errorlevel% 在整行解析时就替换了,那时脚本还没跑,值是 0。拆成两行,echo 在自己的命令行里解析,才拿到 7。

同一行并非完全没法判断:if errorlevel 是执行时求值,call exit-b-demo.bat & if errorlevel 7 echo ... 能正确命中,caller-if.bat 的实测就是这样。

手动调用同理:先 call 脚本.bat,下一行再 echo %errorlevel%。也可以直接用 && / ||,它们按退出码分支,不经过变量:

E:\cmd-demo\args>call need-arg.bat && echo 成功 || echo 失败
缺少参数:用法 need-arg.bat <名字>
失败

PowerShell 里对应的是 $LASTEXITCODE,& .\脚本.bat 之后读它。跨 shell 调用时,这个值比屏幕输出可靠。

截图

速查

写法 作用
%0 脚本自身的调用字符串
%1–%9 位置参数,引号原样保留
%* 原始参数区,不随 shift 改变
%~1 去掉外层引号
%~f1 %~d1 %~p1 %~n1 %~x1 %~nx1 %~dp1 拆分路径,文件不存在也有值
%~z1 %~t1 %~a1 大小、时间、属性,文件不存在为空
shift 参数整体前移一位
if errorlevel N 退出码大于等于 N 时成立
%errorlevel% 当前退出码,块内是旧值
!errorlevel! 延迟展开后的实时值
exit /b [n] 结束当前脚本或子过程,可带退出码
exit [n] 结束整个 cmd 进程

下一篇

脚本能接参数、能返回失败,下一步是把「什么时候跑」交给系统:schtasks 怎么建每天定时任务、开机自启怎么写、任务跑失败去哪里看历史记录,以及为什么手动能跑、计划任务里却提示找不到文件。