先记住三件事
把命令一行行粘进 .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 又怎么把失败传回调用者。