bat.檔案的命令文法

常用命令 

echo、@、call、pause、rem(小技巧：用::代替rem)是批次檔最常用的幾個命令，我們就從他們開始學起。 

==== 注 =========== 
首先, @ 不是一個命令, 而是DOS 批處理的一個特殊標記符, 僅用於屏蔽命令列回顯. 下面是DOS命令列或批處理中可能會見到的一些特殊標記符: 
CR(0D) 命令列結束符 
Escape(1B) ANSI逸出字元引導符 
Space(20) 常用的參數界定符 
Tab(09) ; = 不常用的參數界定符 
+ COPY命令檔案串連符 
* ? 檔案萬用字元 
"" 字串界定符 
| 命令管道符 
< > >> 檔案重新導向符 
@ 命令列回顯屏蔽符 
/ 參數開關引導符 
: 批處理標籤引導符 
% 批處理變數引導符 

其次, :: 確實可以起到rem 的注釋作用, 而且更簡潔有效; 但有兩點需要注意: 
第一, 除了 :: 之外, 任何以 :開頭的字元行, 在批處理中都被視作標號, 而直接忽略其後的所有內容, 只是為了與正常的標號相區別, 建議使用 goto 所無法識別的標號, 即在 :後緊跟一個非字母數位一個特殊符號. 
第二, 與rem 不同的是, ::後的字元行在執行時不會回顯, 無論是否用echo on開啟命令列回顯狀態, 因為命令直譯器不認為他是一個有效命令列, 就此點來看, rem 在某些場合下將比 :: 更為適用; 另外, rem 可以用於 config.sys 檔案中. 
===================== 

echo 表示顯示此命令後的字元 
echo off 表示在此語句後所有啟動並執行命令都不顯示命令列本身 
@與echo off相象，但它是加在每個命令列的最前面，表示運行時不顯示這一行的命令列（只能影響當前行）。 
call 調用另一個批次檔（如果不用call而直接調用別的批次檔，那麼執行完那個批次檔後將無法返回當前檔案並執行當前檔案的後續命令）。 
pause 運行此句會暫停批處理的執行並在螢幕上顯示Press any key to continue...的提示，等待使用者按任意鍵後繼續 
rem 表示此命令後的字元為解釋行（注釋），不執行，只是給自己今後參考用的（相當於程式中的注釋）。 
==== 注 ===== 
此處的描述較為混亂, 不如直接引用個命令的命令列協助更為條理 

------------------------- 
ECHO 

當程式運行時，顯示或隱藏批次程式中的本文。也可用於允許或禁止命令的回顯。 

在運行批次程式時，MS-DOS一般在螢幕上顯示（回顯）批次程式中的命令。 
使用ECHO命令可關閉此功能。 

文法 

ECHO [ON|OFF] 

若要用echo命令顯示一條命令，可用下述文法： 

echo [message] 

參數 

ON|OFF 
指定是否允許命令的回顯。若要顯示當前的ECHO的設定，可使用不帶參數的ECHO 
命令。 

message 
指定讓MS-DOS在螢幕上顯示的本文。 

------------------- 

CALL 

從一個批次程式中調用另一個批次程式，而不會引起第一個批處理的中止。 

文法 

CALL [drive:][path]filename [batch-parameters] 

參數 

[drive:][path]filename 
指定要調用的批次程式的名字及其存放處。檔案名稱必須用.BAT作副檔名。 

batch-parameters 
指定批次程式所需的命令列資訊。 

------------------------------- 

PAUSE 

暫停批次程式的執行並顯示一條訊息，提示使用者按任意鍵繼續執行。只能在批處 
理程式中使用該命令。 

文法 

PAUSE 

REM 

在批次檔或CONFIG.SYS中加入註解。也可用REM命令來屏蔽命令（在CONFIG.SYS 
中也可以用分號 ; 代替REM命令，但在批次檔中則不能替代）。 

文法 

REM [string] 

參數 

string 
指定要屏蔽的命令或要包含的註解。 
======================= 

例1：用edit編輯a.bat檔案，輸入下列內容後存檔為c:/a.bat，執行該批次檔後可實現：將根目錄中所有檔案寫入 a.txt中，啟動UCDOS，進入WPS等功能。 

批次檔的內容為: 命令注釋： 
@echo off 不顯示後續命令列及當前命令列 
dir c:/*.* >a.txt 將c盤檔案清單寫入a.txt 
call c:/ucdos/ucdos.bat 調用ucdos 
echo 你好 顯示"你好" 
pause 暫停,等待按鍵繼續 
rem 準備運行wps 注釋：準備運行wps 
cd ucdos 進入ucdos目錄 
wps 運行wps 

批次檔的參數 

批次檔還可以像C語言的函數一樣使用參數（相當於DOS命令的命令列參數），這需要用到一個參數表示符"%"。 

%[1-9]表示參數，參數是指在運行批次檔時在檔案名稱後加的以空格（或者Tab）分隔的字串。變數可以從%0到%9，%0表示批處理命令本身，其它參數字串用%1到%9順序表示。 

例2：C:根目錄下有一批次檔名為f.bat，內容為： 
@echo off 
format %1 

如果執行C:/>f a: 
那麼在執行f.bat時，%1就表示a:，這樣format %1就相當於format a:，於是上面的命令運行時實際執行的是format a: 

例3：C:根目錄下一批次檔名為t.bat，內容為: 
@echo off 
type %1 
type %2 

那麼運行C:/>t a.txt b.txt 
%1 : 表示a.txt 
%2 : 表示b.txt 
於是上面的命令將順序地顯示a.txt和b.txt檔案的內容。 

==== 注 =============== 
參數在批處理中也作為變數處理, 所以同樣使用百分比符號作為引導符, 其後跟0-9中的一個數字構成參數引用符. 引用符和參數之間 (例如上文中的 %1 與 a: ) 的關係類似於變數指標與變數值的關係. 當我們要引用第十一個或更多個參數時, 就必須移動DOS 的參數起始指標. shift 命令正充當了這個移動指標的角色, 它將參數的起始指標移動到下一個參數, 類似C 語言中的指標操作. 圖示如下: 

初始狀態, cmd 為命令名, 可以用 %0 引用 
cmd arg1 arg2 arg3 arg4 arg5 arg6 arg7 arg8 arg9 arg10 
^ ^ ^ ^ ^ ^ ^ ^ ^ ^ 
| | | | | | | | | | 
%0 %1 %2 %3 %4 %5 %6 %7 %8 %9 

經過1次shift後, cmd 將無法被引用 
cmd arg1 arg2 arg3 arg4 arg5 arg6 arg7 arg8 arg9 arg10 
^ ^ ^ ^ ^ ^ ^ ^ ^ ^ 
| | | | | | | | | | 
%0 %1 %2 %3 %4 %5 %6 %7 %8 %9 

經過2次shift後, arg1也被廢棄, %9指向為空白, 沒有引用意義 
cmd arg1 arg2 arg3 arg4 arg5 arg6 arg7 arg8 arg9 arg10 
^ ^ ^ ^ ^ ^ ^ ^ ^ 
| | | | | | | | | 
%0 %1 %2 %3 %4 %5 %6 %7 %8 

遺憾的是, win9x 和DOS下均不支援 shift 的逆操作. 只有在 nt 核心命令列環境下, shift 才支援 /n 參數, 可以以第一參數為基準返複移動起始指標. 
================= 

特殊命令 

if goto choice for是批次檔中比較進階的命令，如果這幾個你用得很熟練，你就是批次檔的專家啦。 

一、if 是條件陳述式，用來判斷是否符合規定的條件，從而決定執行不同的命令。 有三種格式: 

1、if [not] "參數" == "字串" 待執行的命令 

參數如果等於(not表示不等，下同)指定的字串，則條件成立，運行命令，否則運行下一句。 

例：if "%1"=="a" format a: 

==== 

if 的命令列協助中關於此點的描述為: 
IF [NOT] string1==string2 command 
在此有以下幾點需要注意: 
1. 包含字串的雙引號不是文法所必須的, 而只是習慣上使用的一種"防空"字元 
2. string1 未必是參數, 它也可以是環境變數, 迴圈變數以及其他字串常量或變數 
3. command 不是文法所必須的, string2 後跟一個空格就可以構成一個有效命令列 
============================= 

2、if [not] exist [路徑/]檔案名稱 待執行的命令 
如果有指定的檔案，則條件成立，運行命令，否則運行下一句。 

如: if exist c:/config.sys type c:/config.sys 
表示如果存在c:/config.sys檔案，則顯示它的內容。 

****** 注 ******** 
也可以使用以下的用法: 
if exist command 
device 是指DOS系統中已載入的裝置, 在win98下通常有: 
AUX, PRN, CON, NUL 
COM1, COM2, COM3, COM4 
LPT1, LPT2, LPT3, LPT4 
XMSXXXX0, EMMXXXX0 
A: B: C: ..., 
CLOCK$, CONFIG$, DblBuff$, IFS$HLP$ 
具體的內容會因硬軟體環境的不同而略有差異, 使用這些裝置名稱時, 需要保證以下三點: 
1. 該裝置確實存在(由軟體虛擬裝置除外) 
2. 該裝置驅動程式已載入(aux, prn等標準裝置由系統預設定義) 
3. 該裝置已準備好(主要是指a: b: ..., com1..., lpt1...等) 
可通過命令 mem/d | find "device" /i 來檢閱你的系統中所載入的裝置 
另外, 在DOS系統中, 裝置也被認為是一種特殊的檔案, 而檔案也可以稱作字元裝置; 因為裝置(device)與檔案都是使用控制代碼(handle)來管理的, 控制代碼就是名字, 類似於檔案名稱, 只不過控制代碼不是應用於磁碟管理, 而是應用於記憶體管理而已, 所謂裝置載入也即指在記憶體中為其分配可引用的控制代碼. 
================================== 

3、if errorlevel <數字> 待執行的命令 

很多DOS程式在運行結束後會返回一個數字值用來表示程式啟動並執行結果(或者狀態)，通過if errorlevel命令可以判斷程式的傳回值，根據不同的傳回值來決定執行不同的命令(傳回值必須按照從大到小的順序排列)。如果傳回值等於指定的數字，則條件成立，運行命令，否則運行下一句。 

如if errorlevel 2 goto x2 

==== 注 =========== 
傳回值從大到小的順序排列不是必須的, 而只是執行命令為 goto 時的習慣用法, 當使用 set 作為執行命令時, 通常會從小到大順序排列, 比如需將返回碼置入環境變數, 就需使用以下的順序形式: 

if errorlevel 1 set el=1 
if errorlevel 2 set el=2 
if errorlevel 3 set el=3 
if errorlevel 4 set el=4 
if errorlevel 5 set el=5 
... 

當然, 也可以使用以下迴圈來替代, 原理是一致的: 
for %%e in (1 2 3 4 5 6 7 8...) do if errorlevel %%e set el=%%e 

更高效簡潔的用法, 可以參考我寫的另一篇關於擷取 errorlevel 的文章 

出現此種現象的原因是, if errorlevel 比較返回碼的判斷條件並非等於, 而是大於等於. 由於 goto 的跳轉特性, 由小到大排序會導致在較小的返回碼處就跳出; 而由於 set命令的 "重複" 賦值特性, 由大到小排序會導致較小的返回碼 "覆蓋" 較大的返回碼. 

另外, 雖然 if errorlevel=<數字> command 也是有效命令列, 但也只是 command.com 解釋命令列時將 = 作為命令列切分符而忽略掉罷了 
=========================== 

二、goto 批次檔運行到這裡將跳到goto所指定的標號(標號即label，標號用:後跟標準字串來定義)處，goto語句一般與if配合使用，根據不同的條件來執行不同的命令組。 

如: 

goto end 

:end 
echo this is the end 

標號用":字串"來定義，標號所在行不被執行。 

==== willsort 編注 

label 常被譯為 "標籤" , 但是這並不具有廣泛的約定性. 

goto 與 : 聯用可實現執行中途的跳轉, 再結合 if 可實現執行過程的條件分支, 多個 if 即可實現命令的分組, 類似 C 中 switch case 結構或者 Basic 中的 select case 結構, 大規模且結構化的命令分組即可實現進階語言中的函數功能. 以下是批處理和C/Basic在文法結構上的對照: 

Batch C / Basic 
goto&: goto&: 
goto&:&if if{}&else{} / if&elseif&endif 
goto&:&if... switch&case / select case 
goto&:&if&set&envar... function() / function(),sub() 
================================== 
三、choice 使用此命令可以讓使用者輸入一個字元（用於選擇），從而根據使用者的選擇返回不同的errorlevel，然後於if errorlevel配合，根據使用者的選擇運行不同的命令。 

注意：choice命令為DOS或者Windows系統提供的外部命令，不同版本的choice命令文法會稍有不同，請用choice /?查看用法。 
choice的命令文法（該文法為Windows 2003中choice命令的文法，其它版本的choice的命令文法與此大同小異）： 

CHOICE [/C choices] [/N] [/CS] [/T timeout /D choice] [/M text] 

描述: 
該工具允許使用者從挑選清單選擇一個項目並返回所選項目的索引。 

參數列表: 
/C choices 指定要建立的選項列表。預設列表是 "YN"。 

/N 在提示符中隱藏選項列表。提示前面的訊息得到顯示， 
選項依舊處於啟用狀態。 

/CS 允許選擇分大小寫選項。在預設情況下，這個工具 
是不分大小寫。 

/T timeout 做出預設選擇之前，暫停秒數。可接受的值是從 0 
到 9999。如果指定了 0，就不會有暫停，預設選項 
會得到選擇。 

/D choice 在 nnnn 秒之後指定預設選項。字元必須在用 /C 選 
項指定的一組選擇中; 同時，必須用 /T 指定 nnnn。 

/M text 指定提示之前要顯示的訊息。如果沒有指定，工具只 
顯示提示。 

/? 顯示協助訊息。 

注意: 
ERRORLEVEL 環境變數被設定為從選擇集選擇的鍵索引。列出的第一個選 
擇返回 1，第二個選擇返回 2，等等。如果使用者按的鍵不是有效選擇， 
該工具會發出警告響聲。如果該工具檢測到錯誤狀態，它會返回 255 的 
ERRORLEVEL 值。如果使用者按 Ctrl+Break 或 Ctrl+C 鍵，該工具會返回 0 
的 ERRORLEVEL 值。在一個批程式中使用 ERRORLEVEL 參數時，將參數降 
序排列。 

樣本: 
CHOICE /? 
CHOICE /C YNC /M "確認請按 Y，否請按 N，或者取消請按 C。" 
CHOICE /T 10 /C ync /CS /D y 
CHOICE /C ab /M "選項 1 請選擇 a，選項 2 請選擇 b。" 
CHOICE /C ab /N /M "選項 1 請選擇 a，選項 2 請選擇 b。" 

==== willsort 編注 =============================== 
我列出win98下choice的用法協助, 已資區分 

Waits for the user to choose one of a set of choices. 
等待使用者選擇一組待選字元中的一個 

CHOICE [/C[:]choices] [/N] [/S] [/T[:]c,nn] [text] 

/C[:]choices Specifies allowable keys. Default is YN 
指定允許的按鍵(待選字元), 預設為YN 
/N Do not display choices and ? at end of prompt string. 
不顯示提示字串中的問號和待選字元 
/S Treat choice keys as case sensitive. 
處理待選字元時大小寫敏感 
/T[:]c,nn Default choice to c after nn seconds 
在 nn 秒後預設選擇 c 
text Prompt string to display 
要顯示的提示字串 
ERRORLEVEL is set to offset of key user presses in choices. 
ERRORLEVEL 被設定為使用者鍵入的字元在待選字元中的位移值 
如果我運行命令：CHOICE /C YNC /M "確認請按 Y，否請按 N，或者取消請按 C。" 
螢幕上會顯示： 
確認請按 Y，否請按 N，或者取消請按 C。 [Y,N,C]? 

例：test.bat的內容如下（注意，用if errorlevel判斷傳回值時，要按傳回值從高到低排列）: 
@echo off 
choice /C dme /M "defrag,mem,end" 
if errorlevel 3 goto end 
if errorlevel 2 goto mem 
if errorlevel 1 goto defrag 

:defrag 
c:/dos/defrag 
goto end 

:mem 
mem 
goto end 

:end 
echo good bye 

此批處理運行後，將顯示"defrag,mem,end[D,M,E]?" ，使用者可選擇d m e ，然後if語句根據使用者的選擇作出判斷，d表示執行標號為defrag的程式段，m表示執行標號為mem的程式段，e表示執行標號為end的程式段，每個程式段最後都以goto end將程式跳到end標號處，然後程式將顯示good bye，批處理運行結束。 

四、for 迴圈命令，只要條件符合，它將多次執行同一命令。 

文法： 
對一組檔案中的每一個檔案執行某個特定命令。 

FOR %%variable IN (set) DO command [command-parameters] 

%%variable 指定一個單一字母可替換的參數。 
(set) 指定一個或一組檔案。可以使用萬用字元。 
command 指定對每個檔案執行的命令。 
command-parameters 
為特定命令指定參數或命令列開關。 

例如一個批次檔中有一行: 
for %%c in (*.bat *.txt) do type %%c 

則該命令列會顯示目前的目錄下所有以bat和txt為副檔名的檔案的內容。 

==== willsort 編注 ===================================================== 
需要指出的是, 當()中的字串並非單個或多個檔案名稱時, 它將單純被當作字串替換, 這個特性再加上()中可以嵌入多個字串的特性, 很明顯 for 可以被看作一種遍曆型迴圈. 
當然, 在 nt/2000/xp/2003 系列的命令列環境中, for 被賦予了更多的特性, 使之可以分析命令輸出或者檔案中的字串, 也有很多開關被用於擴充了檔案替換功能. 
======================================================================== 

批處理樣本 

1. IF-EXIST 

1) 首先用記事本在C:/建立一個test1.bat批次檔，檔案內容如下： 
@echo off 
IF EXIST /AUTOEXEC.BAT TYPE /AUTOEXEC.BAT 
IF NOT EXIST /AUTOEXEC.BAT ECHO /AUTOEXEC.BAT does not exist 

然後運行它： 
C:/>TEST1.BAT 

如果C:/存在AUTOEXEC.BAT檔案，那麼它的內容就會被顯示出來，如果不存在，批處理就會提示你該檔案不存在。 

2) 接著再建立一個test2.bat檔案，內容如下： 
@ECHO OFF 
IF EXIST /%1 TYPE /%1 
IF NOT EXIST /%1 ECHO /%1 does not exist 

執行: 
C:/>TEST2 AUTOEXEC.BAT 
該命令運行結果同上。 

說明： 
(1) IF EXIST 是用來測試檔案是否存在的，格式為 
IF EXIST [路徑+檔案名稱] 命令 
(2) test2.bat檔案中的%1是參數，DOS允許傳遞9個批參數資訊給批次檔，分別為%1~%9(%0表示test2命令本身) ，這有點象編程中的實參和形參的關係，%1是形參，AUTOEXEC.BAT是實參。 

==== willsort 編注 ===================================================== 
DOS沒有 "允許傳遞9個批參數資訊" 的限制, 參數的個數只會受到命令列長度和所調用命令處理能力的限制. 但是, 我們在批次程式中, 在同一時刻只能同時引用10個參數, 因為 DOS只給出了 %0~%9這十個參數引用符. 
======================================================================== 

3) 更進一步的，建立一個名為TEST3.BAT的檔案，內容如下： 
@echo off 
IF "%1" == "A" ECHO XIAO 
IF "%2" == "B" ECHO TIAN 
IF "%3" == "C" ECHO XIN 

如果運行： 
C:/>TEST3 A B C 
螢幕上會顯示: 
XIAO 
TIAN 
XIN 

如果運行： 
C:/>TEST3 A B 
螢幕上會顯示 
XIAO 
TIAN 

在這個命令執行過程中，DOS會將一個Null 字元串指定給參數%3。 

2、IF-ERRORLEVEL 

建立TEST4.BAT，內容如下： 
@ECHO OFF 
XCOPY C:/AUTOEXEC.BAT D:/ 
IF ERRORLEVEL 1 ECHO 檔案拷貝失敗 
IF ERRORLEVEL 0 ECHO 成功拷貝檔案 

然後執行檔案: 
C:/>TEST4 

如果檔案拷貝成功，螢幕就會顯示"成功拷貝檔案"，否則就會顯示"檔案拷貝失敗"。 

IF ERRORLEVEL 是用來測試它的上一個DOS命令的傳回值的，注意只是上一個命令的傳回值，而且傳回值必須依照從大到小次序順序判斷。 
因此下面的批次檔是錯誤的： 

@ECHO OFF 
XCOPY C:/AUTOEXEC.BAT D:/ 
IF ERRORLEVEL 0 ECHO 成功拷貝檔案 
IF ERRORLEVEL 1 ECHO 未找到拷貝檔案 
IF ERRORLEVEL 2 ECHO 使用者通過ctrl-c中止拷貝操作 
IF ERRORLEVEL 3 ECHO 預置錯誤阻止檔案拷貝操作 
IF ERRORLEVEL 4 ECHO 拷貝過程中寫盤錯誤 

無論拷貝是否成功，後面的： 

未找到拷貝檔案 
使用者通過ctrl-c中止拷貝操作 
預置錯誤阻止檔案拷貝操作 
拷貝過程中寫盤錯誤 

都將顯示出來。 

以下就是幾個常用命令的傳回值及其代表的意義： 

backup 
0 備份成功 
1 未找到備份檔案 
2 檔案分享權限設定衝突阻止備份完成 
3 使用者用ctrl-c中止備份 
4 由於致命的錯誤使備份操作中止 

diskcomp 
0 盤比較相同 
1 盤比較不同 
2 使用者通過ctrl-c中止比較操作 
3 由於致命的錯誤使比較操作中止 
4 預置錯誤中止比較 

diskcopy 
0 盤拷貝操作成功 
1 非致命盤讀/寫錯 
2 使用者通過ctrl-c結束拷貝操作 
3 因致命的處理錯誤使盤拷貝中止 
4 預置錯誤阻止拷貝操作 

format 
0 格式化成功 
3 使用者