batch 指令筆記

January 1st, 1970

想要將指令集合起來並且自動化執行，批次檔絕對是你不可或缺的技能之一。

在 StackOverflow 上有個回答包含了很完整的批次檔樣板，template.bat，可以從這個樣版上學到很多技巧，值得一看。

批次檔基本介紹與語法

將命令提示字元(Command Prompt)中輸入的指令集結起來，輸入在文字檔中，用以批次執行，稱之為批次(Batch file)檔。

請注意！命令提示字元預設的字碼頁為 ANSI/BIG5 編碼，因此檢視 UTF-8 編碼檔案時會出現亂碼，所以批次檔的編寫應盡量使用 ANSI 的編碼方式。

副檔名

預設有下面這 2 種，在 DOS 與 Windows 9x 時代副檔名為 .bat，在 Windows NT 之後則改用 .cmd，表示在視窗模式下的命令提示字元(cmd.exe)執行。

註解方式

標準是使用 rem，大小寫沒差別，另外可使用 2 個冒號來當註解符號。

rem
::

顯示訊息

用來顯示訊息的指令是 echo，其後可加上字串或變數(可混搭)，在正常的情況下，批次檔中的每道指令執行前都會先出現螢幕上，使用 echo off 指令，就可以關閉顯示指令，通常在不需要互動的批次檔中都一定會出現。

@echo off
set /P myname=Please input your name:
echo Hello %myname%
echo.
echo Today is %date% %time%
pause

停止下達的指令顯示在螢幕上 => echo off
空一行 => echo.
顯示當前目錄 => echo %cd%
顯示日期 => echo %date%
顯示時間 => echo %time%

後面三個指令主要是使用 Windows 環境變數來輸出資訊。

判斷(if)

直接參考 if /?

暫停

pause 程式暫停，提示按任意鍵繼續

echo This Program is running...
pause

timeout [/T | time]，程式暫停指定的秒數

echo Please wait for a while...
timeout 6

回傳值

無論是在 Linux 下撰寫 shell script 或是在 Windows 下撰寫批次檔，最近一次程式執行的回傳值判斷，在撰寫工作自動化的 Script 檔時，是非常重要的技巧。

在 Windows 環境中的慣例是，若指令成功時傳回 0，若錯誤時，依據錯誤的狀況會傳回 1 或以上的值，代表不同的錯誤狀況。

但並非所有指令都會根據正確或錯誤而有不同的回傳值，要用來判斷前請先測試一下。

ping 168.95.192.1
echo %errorlevel%
REM 成功,回傳 1

ping 123.123.123.123
echo %errorlevel%
REM 失敗,回傳 0

命令列參數

假設在命令列鍵入了下列指令

test.cmd c:\windows\notepad.exe c:\windows\write.exe

此時批次檔內部自動將命令列上的參數視為特別的變數如下表：

%0 (命令)	%1 (參數1)	%2 (參數2)
test.cmd	c:\windows\notepad.exe	c:\windows\write.exe

擴充字元參數

若在批次檔內的命令列參數加上擴充字元之後，可額外得知參數的許多資訊，請參考下表

%1	%~d1 (取得磁碟機代號)	%~p1 (取得路徑)	%~n1 (取得檔名)	%~x1 (取得副檔名)
c:\windows\notepad.exe	c:	\Windows\	notepad	.exe

跳行與結束程式

goto 標籤 (須定義標籤，標籤須單獨一行，並以冒號開頭，例如 :header)
goto :eof (無須定義標籤，直接結束程式之意)
exit /b [回傳值]

使用 exit /b 可停止批次檔或副程式的執行，若結束後需要提供回傳值讓 if 指令檢查 errorlevel 變數，可於其後面加上想要的回傳數值。

命令列特性

多行指令合併

要將分開多行的指令寫成一行，可利用 &

dir & pause

切換目錄：CD

路徑中含有空白字元時，請使用雙引號括起來

cd "\winnt\profiles\username\programs\start menu"

cd /d "%~dp0"

echo %CD%

顯示目前磁碟機

echo %CD:~0,3%

黑洞：nul

一般用來將指令的正常訊息導向至黑洞 nul，使正常訊息不要顯示在螢幕上，然後配合判斷 errorlevel 或 %errorlevel% 變數，寫入 log 檔

ping 168.95.192.1 > nul
if errorlevel 1 echo ping target fail >> pinglog.txt

參考資料：

Poy Chang

Trial and Error

Recent Posts