はじめに — .bat と .cmd

なぜ今バッチを学ぶのか

より良い言語がいくらでもある2026年に、あえてバッチを学ぶ理由は1つだけです。Windows にはバッチが最初から入っているからです。

• 実行環境の準備が不要。Node.js も .NET SDK も要らない
• タスクスケジューラ、インストーラ、CI の設定、他人が10年前に書いたスクリプト — 現場にはバッチが残っている
• 読める必要がある。書けなくても、読めないと既存の仕組みを触れない

この勉強会は「バッチで何でも書けるようになる」ことを目指しません。読めることと、数十行までなら自分で書けることを目標にします。

.bat と .cmd はどちらを使うか

最初に決着させます。新しく作るなら .cmd、既存のファイルに合わせるならそれに従う。これだけ覚えれば十分です。

実務上の差は1つだけあります。set や path のような一部の内部コマンドを実行したとき、.cmd は終了コードを 0 にリセットしますが、.bat はリセットしません。

@echo off
call :fail
echo before set: %errorlevel%
set FOO=bar
echo after  set: %errorlevel%
goto :eof
:fail
exit /b 1

同じ内容を拡張子だけ変えて実行した結果です。

before set: 1
after  set: 1

before set: 1
after  set: 0

.bat では失敗の記録が残り続け、.cmd では set を通過した時点で消えます。エラー処理を書くときに .cmd のほうが挙動が素直なので、新規は .cmd を選びます。

既知の言語との対応（と、対応が破綻するところ）

JavaScript / Java / C# を知っている人向けに、対応表を先に置きます。重要なのは右端の列です。似ているところより、似ていないところのほうが後で問題になります。

実行モデル — 1行が実行されるまで

この章がこの回の中心です。ここを理解すると、後で出てくる「よく分からない例外規則」の大半が説明できます。

バッチは言語ではなく、コマンドの並び

JavaScript や Java の処理系は、ソース全体を読んで構文木を作り、それを実行します。バッチは違います。cmd.exe はファイルを1行読んで、文字列を置換して、コマンドを起動する。これを繰り返すだけです。

置換であることの帰結

「変数を読む」が「その位置に値の文字列を貼り込む」であるため、次のようなことが起きます。

1. 未定義の変数は空にならない

@echo off
echo [%UNDEFINED_VAR%]

[%UNDEFINED_VAR%]

JavaScript なら undefined、Java ならコンパイルエラーですが、バッチは置換できないので元の文字列を残します。if "%A%"=="x" で比較が成立しないときは、まずこれを疑います。

2. 置換した結果が、もう一度コマンドとして読み直される

これがこの回で一番重要な帰結です。置換は文字列を貼り込むだけなので、貼り込んだ値の中にある記号も、コマンドの記号として解釈されます。

@echo off
set MSG=Hello & echo あとがき
echo %MSG%

まず set の行が壊れています。& はコマンドの区切りなので、この行は「MSG に Hello を代入」と「echo あとがき を実行」の2つのコマンドとして扱われます。

代入だけなら set "名前=値" の形で守れます。

@echo off
setlocal enabledelayedexpansion
set "MSG=Hello & World"
echo A: %MSG%
echo B: !MSG!
echo C: "%MSG%"

A: Hello
'World' は、内部コマンドまたは外部コマンド、
操作可能なプログラムまたはバッチ ファイルとして認識されていません。
B: Hello & World
C: "Hello & World"

変数には Hello & World が正しく入っています。それでも A は壊れます。echo %MSG% が置換されて echo Hello & World という行になり、その行がコマンドとして読み直されるからです。& 以降は別のコマンドとして実行され、World というコマンドを探しに行きます。

B の !MSG! は正しく表示されます。遅延展開は実行の直前に値を差し込み、その結果を読み直しません。C のように引用符で囲む方法もありますが、引用符自体も表示されてしまいます。

3. rem の行でも解析は行われる

次の1行だけでバッチが停止します。コメントなのに、です。

rem 引数と %~ 修飾子の確認

バッチ パラメーターの置き換え中で、パス演算子の次の使用方法は無効です:
%~ 修飾子の確認

%~ の直後は修飾子（f d n など）でなければならず、空白が来ると無効と判断されます。rem はその行を実行しないだけで、行を読み込んで置換する処理はその前に走っています。

コメントの中でも % は特別な文字です。日本語の説明を書くときに %~ や %1 のような表記を含めると、コメントが原因でバッチが動かなくなります。

4. % はエスケープが必要になる

echo 進捗: 50%
echo 進捗: 50%%

進捗: 50
進捗: 50%

バッチファイル内では %% と書きます。コマンドプロンプトに直接打つときは % 1つで済むため、プロンプトで試したコードを貼るとここだけ崩れます。

最低限の定型句

変数 — すべては文字列

代入は set "名前=値" の形で書く

= の前後に空白を入れないこと、そして囲むのは値だけでなく「名前＝値」の全体であることが要点です。set NAME="太郎" と書くと、引用符が値の一部として保存されてしまいます。

すべての値は文字列

@echo off
set "N=5"
set "M=3"
echo %N% + %M% は %N%%M%

5 + 3 は 53

数値として計算するには set /a を使います。

@echo off
set /a SUM=5+3
set /a DIV=7/2
set /a MOD=7%%2
echo %SUM% %DIV% %MOD%

8 3 1

整数のみで、小数は扱えません（7/2 は 3）。剰余の % はバッチ内では %% と書きます。

スコープは setlocal しかない

set はプロセスの環境変数を書き換えます。ブロックスコープも関数スコープもありません。

@echo off
rem これを実行すると、実行後のコンソールでも PATH が変わったまま
set "PATH=C:\mytools"

setlocal を宣言すると、それ以降の変更はスクリプト終了時に破棄されます。

@echo off
setlocal
set "PATH=C:\mytools;%PATH%"
rem …処理…
rem スクリプトが終わると PATH は元に戻る

実務では次の形が標準です。第2回で扱う !VAR! を有効にするオプションを最初から付けておきます。

@echo off
setlocal enabledelayedexpansion

変数の一覧と確認

よく使う組み込み変数です。

終了コード — 例外のない世界

バッチに例外はない

これがバッチで最も事故を生む性質です。コマンドが失敗しても、次の行はそのまま実行されます。

@echo off
copy "C:\notexist\a.txt" "D:\backup\"
del "C:\notexist\a.txt"
echo 完了しました

コピーが失敗してエラーメッセージが出ても、del が実行され、完了しました まで表示されます。JavaScript なら throw で止まり、Java なら例外が呼び出し元へ伝播するところですが、バッチは失敗を数値で記録するだけです。

ERRORLEVEL の読み方

if errorlevel 1 が「1以上」という点は繰り返し引っかかるところです。終了コードが 5 でも真になります。

実務で使うのは && と ||

JavaScript の短絡評価と同じ記号ですが、判定するのは真偽値ではなく終了コードです。

@echo off
rem 失敗したらメッセージを出して終了する定型
copy "%SRC%" "%DST%" || (
    echo コピーに失敗しました
    exit /b 1
)
echo コピーしました

自分の終了コードを返す

終了コードの意味はコマンドごとに違う

知らないコマンドを使うときは コマンド /? で終了コードの説明を読んでから、エラー処理を書きます。

引数と自分の居場所

引数の受け取り

引数は %~1 で受け取り、使うときに改めて引用符で囲むのが定型です。こうすれば呼び出し側が囲んでいても囲んでいなくても同じ形で扱えます。

@echo off
setlocal
if "%~1"=="" (
    echo 使い方: %~nx0 ^<対象ファイル^>
    exit /b 1
)
set "TARGET=%~1"
if not exist "%TARGET%" (
    echo 見つかりません: %TARGET%
    exit /b 1
)
echo 対象: %TARGET%

%~ 修飾子でパスを分解する

%1 に C:\work\data\input.txt が渡された場合の展開結果です。

他の言語なら path.basename() や Path.GetFileName() を呼ぶところですが、バッチではこの修飾子が同じ役割を果たします。

%~dp0 — 自分がどこにいるか

この修飾子を %0（自分自身）に適用すると、バッチが置かれているフォルダが得られます。これが実務で最も使う記法です。

@echo off
echo バッチの場所: %~dp0
echo カレント     : %CD%

この2つは別物です。相対パスの起点はカレントディレクトリであり、バッチの場所ではありません。ダブルクリックで実行すると一致しますが、タスクスケジューラや別フォルダから呼ばれると一致しません。

@echo off
rem 同じフォルダの config.ini を確実に読む
for /f "delims=" %%l in ("%~dp0config.ini") do echo %%l

rem あるいはカレントを移動してしまう
pushd "%~dp0" || exit /b 1
rem …処理…
popd

デモ — 最初のバッチを書く

ここまでの内容だけで、実際に使えるものを1つ作ります。指定したファイルを、日付付きの名前でバックアップフォルダにコピーするバッチです。

この題材は第2回・第3回でも育てていきます。段階を追って、なぜその1行が必要になるかを見ます。

Step 1: とにかく動かす

@echo off
copy "C:\work\data.txt" "C:\backup\data.txt"
echo 完了

動きますが、対象を変えるたびにファイルを書き換える必要があります。

Step 2: 変数にする

@echo off
setlocal

set "SRC=C:\work\data.txt"
set "DSTDIR=C:\backup"

copy "%SRC%" "%DSTDIR%\"
echo 完了

設定が先頭に集まり、読みやすくなりました。setlocal があるので、実行後にコンソールの環境変数が汚れることもありません。

Step 3: 日付を付ける

@echo off
setlocal

set "SRC=C:\work\data.txt"
set "DSTDIR=C:\backup"

rem %DATE% は 2026/08/25 形式。/ を削除して 20260825 にする
set "TODAY=%DATE:/=%"

copy "%SRC%" "%DSTDIR%\%TODAY%_data.txt"
echo 完了

%DATE:/=% は「/ を空文字に置換する」という記法です（第2回で詳しく扱います）。

要注意この方法は地域設定に依存します。区切りが - の環境では効きません。環境に依存しない日付の取得方法は第3回で扱います。

Step 4: 失敗を検知する

@echo off
setlocal

set "SRC=C:\work\data.txt"
set "DSTDIR=C:\backup"
set "TODAY=%DATE:/=%"

rem コピー元がなければ、その時点でやめる
if not exist "%SRC%" (
    echo [エラー] コピー元が見つかりません: %SRC%
    exit /b 1
)

rem 保存先フォルダがなければ作る
if not exist "%DSTDIR%\" md "%DSTDIR%"

copy "%SRC%" "%DSTDIR%\%TODAY%_%~nx1" >nul || (
    echo [エラー] コピーに失敗しました
    exit /b 1
)

echo 完了: %DSTDIR%\%TODAY%_data.txt
exit /b 0

エラー処理が入って、はじめて「他人に渡せる」方向に一歩進みました。>nul は copy の「1 個のファイルをコピーしました。」という出力を捨てるためです。

Step 5: 引数で受け取る

@echo off
setlocal

rem --- 引数チェック ---
if "%~1"=="" (
    echo 使い方: %~nx0 ^<バックアップするファイル^>
    exit /b 1
)

set "SRC=%~1"
set "DSTDIR=%~dp0backup"
set "TODAY=%DATE:/=%"

if not exist "%SRC%" (
    echo [エラー] コピー元が見つかりません: %SRC%
    exit /b 1
)

if not exist "%DSTDIR%\" md "%DSTDIR%"

rem %~nx1 で「ファイル名＋拡張子」を取り出して名前を組み立てる
set "DST=%DSTDIR%\%TODAY%_%~nx1"

copy "%SRC%" "%DST%" >nul || (
    echo [エラー] コピーに失敗しました
    exit /b 1
)

echo 完了: %DST%
exit /b 0

これで、どのファイルにも使える汎用のバックアップツールになりました。%~dp0backup としたので、保存先はバッチと同じ場所の backup フォルダになり、どこから実行しても同じ場所に保存されます。

サンプルは samples\01\ に置いてあります。

まとめと第2回の予告

この回の要点

第2回で扱うこと

次回は制御構文です。if と for を扱いますが、中心になるのはこの回の「置換」が引き起こす問題です。

@echo off
setlocal
set count=0
for %%f in (*.txt) do (
    set /a count=count+1
    echo 現在: %count%
)
echo 合計: %count%

このコードは、.txt が3つあるフォルダで実行すると 現在: 0 を3回表示し、最後に 合計: 3 と表示します。なぜそうなるのかを、この回の実行モデルの図で説明できるようにするのが第2回の前半です。

この回に関連する落とし穴

詳しくは落とし穴カタログを参照してください。

記法の確認は記法早見表、目的から引くときは逆引き参照を使ってください。