先记住三件事

把命令一行行粘进 .bat,跑不对通常不是命令写错,而是三件事没处理:回显让输出混着命令本身,路径用的是调用者的当前目录,变量在括号块里取到的是旧值。下面按这个顺序,每条都给本机实跑的输出。

测试目录是 E:\cmd-demo\bat,setup.ps1 负责重新生成所有脚本,脚本本身都保留在目录里。本机系统代码页是 936,下面没有特别说明的脚本都按 GBK 保存。

@echo off 关的是命令回显

同一个脚本,首行写不写 @,输出差一行:

E:\cmd-demo\bat>echo-off.bat
E:\cmd-demo\bat>echo off
第一行

第三行
ECHO 处于关闭状态。

echo off 自己被打印出来了,因为关闭回显这个动作发生在执行它之后。首行改成 @echo off,@ 让这一行也不回显:

E:\cmd-demo\bat>echo-at.bat
第一行

第三行

关掉的只是「命令本身」,echo 第一行 的输出照常打印。两个细节:

  • 空行要用 echo.,只写 echo 会打印当前状态,上面那句 ECHO 处于关闭状态。 就是这么来的。
  • 脚本第一行别写 echo off,直接写 @echo off,否则每次运行都多一行提示符。

截图

echo on 用来看每一步

E:\cmd-demo\bat>echo-debug.bat
E:\cmd-demo\bat>echo 调试输出
调试输出

E:\cmd-demo\bat>set /a n=1+1

E:\cmd-demo\bat>echo n=2
n=2
调试结束

开回显后,命令先打印一遍,再打印结果,echo n=2 看起来像重复,这是正常的。调试时在可疑段落前写 echo on,结束后补 @echo off,只适合小范围,整脚本开着会刷屏。

它还能看出变量是什么时候被替换的:命令打印出来时,%n% 已经是替换后的值。如果打印的命令和你写的不一样,问题就在展开时机,而不是命令本身。

截图

rem 是注释,:: 是标签

E:\cmd-demo\bat>rem-colon.bat
两行注释都不显示
块内还能执行
结束

rem 是命令,后面整行被忽略;:: 本质是一个空标签,cmd 读到标签就跳过该行。块里单独占一行的 ::,本机实测能过。

但把它塞进 do 或 ( 的同一行:

E:\cmd-demo\bat>colon-inline.bat
命令语法不正确。

退出码 255。标签必须独占一行,for ... do :: 注释 会让 cmd 在解析括号块时遇到一个标签,块结构直接断掉。所以注释统一用 rem,不要为省两个字符用 ::。

截图

pause 遇到重定向就不等人

E:\cmd-demo\bat>pause-demo.bat < nul
第一步
请按任意键继续. . .
第二步

pause 要的是「任意键」,< nul 把空输入喂给它,没人按键也立刻返回,提示照样打印。第二条 < nul >nul 连提示都被吞掉,屏幕上什么都没有,但脚本确实跑完了。

这解释了两个现象:双击运行时没有重定向,pause 会真的停住,所以脚本结尾常放一个;从管道、计划任务或 cmd /c 里调用时,它可能根本不停。要判断脚本有没有跑完,看输出或退出码,别指望 pause。

也正因为这样,把 pause 放在脚本中间当「确认步骤」并不可靠:调用方一旦重定向了输入,它会直接跳过,后面的命令照跑。

截图

%0、%cd%、%~dp0 不是一回事

从 E:\cmd-demo 用相对路径调用:

E:\cmd-demo>bat\where-am-i.bat
0=bat\where-am-i.bat
cd=E:\cmd-demo
dp0=E:\cmd-demo\bat\
after=E:\cmd-demo\bat
  • %0 是调用时写的那个字符串。这里是相对路径;双击时是带引号的完整路径,所以不能拿它拼目录。
  • %cd% 是调用者的当前目录。脚本里直接 cd 数据,找的是调用者脚下的 数据,不是脚本旁边的。
  • %~dp0 是脚本所在目录,末尾自带反斜杠。%~ 去掉外层引号,d 是盘符,p 是路径。

所以固定写法是开头一行:

cd /d "%~dp0"

/d 不能省,跨盘符时只写 cd 不会真的切过去。脚本里所有相对路径都应当以这一行为前提。

拼接时注意 %~dp0 自带末尾反斜杠,写 "%~dp0data\a.txt" 就够了,再补一个 \ 会多出一层分隔符。

截图

循环里的变量为什么要加感叹号

E:\cmd-demo\bat>var-off.bat
循环内 n=0
循环内 n=0
循环内 n=0
循环外 n=3

E:\cmd-demo\bat>var-on.bat
循环内 n=1
循环内 n=2
循环内 n=3
循环外 n=3

cmd 在执行整个括号块之前,就把块里的 %n% 替换成了当时的值。循环真正跑起来后 n 虽然变了,echo 里的文本已经定死,于是三次都是 0;循环结束后才取到 3。

打开延迟展开,块里改用 !n!,值到执行那一行才取:

setlocal enabledelayedexpansion
for %%i in (a b c) do (
  set /a n+=1
  echo 循环内 n=!n!
)

setlocal 还顺带把变量改动限制在脚本内,脚本结束自动恢复,不会污染调用它的命令行。

截图

中文路径、空格和编码

中文目录可以直接跑:

E:\cmd-demo\bat>中文目录\hello.bat
中文目录里的脚本
cd=E:\cmd-demo\bat

麻烦出在脚本文件本身的编码。同一个脚本存成无 BOM 的 UTF-8,在 936 下运行:

E:\cmd-demo\bat>utf8.bat
杩欐槸 UTF-8 鏃?BOM 鐨勪腑鏂?

先切代码页再运行,显示就正常:

E:\cmd-demo\bat>chcp 65001>nul & utf8.bat
这是 UTF-8 无 BOM 的中文

两种稳妥做法:脚本存成 GBK(记事本里叫 ANSI);或者文件存 UTF-8 并在开头 chcp 65001。注意 chcp 只影响当前这个 cmd 窗口,换个窗口又回到 936。

改编码最省事的是编辑器:VS Code 右下角点编码,选「通过编码保存」再选 GBK;记事本用「另存为」,编码选 ANSI。改完重新运行,不要只改 chcp 而不动文件。

路径带空格是另一类问题:

E:\cmd-demo\bat>my dir\hello.bat
'my' 不是内部或外部命令,也不是可运行的程序
或批处理文件。

E:\cmd-demo\bat>"my dir\hello.bat"
带空格目录里的脚本

cmd 先按空格把整行切段,my 被当成命令名。调用脚本、cd、copy,只要路径可能带空格,统一加英文双引号。

截图

截图

双击一闪而过

双击 bat,cmd 用 /c 跑完就关窗口,脚本里的报错根本来不及看。常见处理有两种:在可能失败的步骤后面加 pause,或者干脆从命令行运行脚本。窗口一闪而过往往不是脚本没跑,而是跑完就退了;先看退出码和输出,再判断。

写脚本的顺序也值得固定下来:先在命令行逐条跑,确认每条的输出;再写进 bat,用命令行调用,报错才会留在窗口里;在可疑段落前后插 echo 进入某段 / echo 退出某段;跑完补一句 echo %errorlevel%,0 和 255 的差别比任何提示都直接。

速查

写法 作用
@echo off 关命令回显,@ 连本行也不显示
echo on 临时打开回显,看每一步
echo. 打印空行
echo 打印回显状态,不是空行
rem 文字 注释,任何位置都安全
:: 文字 空标签,块内单独一行可用,别写进 do 同行
pause 等按键;有重定向输入时立刻返回
%0 调用时写的路径字符串
%cd% 调用者的当前目录
%~dp0 脚本所在目录,带末尾反斜杠

常见现象对照:

现象 原因 处理
每次多打一行 echo off 首行没写 @ 改成 @echo off
中文输出是乱码 脚本编码与代码页不一致 存 GBK,或 chcp 65001 配 UTF-8
'my' 不是内部或外部命令 路径带空格没加引号 整条路径加英文双引号
命令语法不正确。 :: 写进 do 或 ( 同一行 换 rem,标签独占一行
循环里变量一直不变 块里用了 %n% 开延迟展开,改用 !n!
脚本里的 cd 找不到目录 用的是调用者目录 开头 cd /d "%~dp0"
窗口一闪而过 跑完自动关 结尾 pause,或从命令行运行

下一篇

脚本能稳定跑起来之后,下一步是让它能接收输入、能判断结果:%1、%*、shift 怎么传参,路径带空格时参数为什么会被拆开,if exist 和 if errorlevel 怎么用,%errorlevel% 与 exit /b 又怎么把失败传回调用者。