この回の位置づけ — 「動く」から「渡せる」へ

第1回と第2回で書いたコードは、自分の環境で自分が実行する分には動きます。この回で扱うのは、それを他人に渡したり、タスクスケジューラに登録したりしたときに壊れる部分です。

いま残っている問題

この回の進み方

各章で1つずつ問題を潰し、最後にそのすべてを組み込んだテンプレートにまとめます。テンプレートは docs\samples\templates\ に置いてあるので、次に書くバッチはそれをコピーして始められます。

文字コードとコードページ

2つの設定が噛み合う必要がある

日本語が化けるかどうかは、ファイルの文字コードと実行時のコンソールのコードページの組み合わせで決まります。ファイルを正しく保存しただけでは足りません。

安定して動く組み合わせは1行目だけです。バッチファイルは SJIS（CP932）+ CRLF で保存するのが結論になります。

コードページは継承される

コードページは親プロセスから受け継がれます。エクスプローラからダブルクリックすればシステムの既定（日本語 Windows なら 932）ですが、UTF-8 に設定されたターミナルや CI から呼ばれると 65001 のまま実行されます。

「自分の環境では動くのに、CI やタスクランナー経由だと化ける」という現象はこれが原因です。現在値は chcp で確認できます。

C:\>chcp
現在のコード ページ: 932

化けると「表示が崩れる」だけでは済まない

これが文字コードを軽視できない理由です。化けた結果のバイト列に & や | に相当するものが現れると、構文エラーや意図しないコマンド実行になります。日本語のコメント行1つでバッチ全体が動かなくなることもあります。

呼び出し元を制御できない場合の方針

コンソールのコードページは、同じウィンドウで動くすべてのプロセスが共有し、バッチが終わっても戻りません。setlocal の対象外です。終了時に元へ戻す形にしても、パイプで同時に動く別のプロセスが切り替え後の値を元の値として控えてしまい、ウィンドウに残ります。chcp の出力書式（現在のコード ページ: 932 / Active code page: 932.）も OS の表示言語で変わるため、元の値の取り出し自体がロケール依存です。バッチの中ではコードページを変えず、メッセージを英数字にするか、呼び出し側の設定を揃えます。

化けてしまったウィンドウを人が手で直すときは、そのウィンドウで chcp 932 を打ちます。

エディタの設定

UTF-8 が必要な処理がある場合は、バッチ側は SJIS のまま保ち、その処理だけを PowerShell スクリプトに切り出して powershell -File で呼ぶほうが安全です。

日時を確実に取得する

%DATE% と %TIME% の問題

この2つをそのままファイル名に使うと、午前0時台だけファイル名が壊れる、といった時間帯依存のバグになります。

3つの方法を比較する

いずれも 20260825_004102 形式のタイムスタンプを作る例です。

方法1: PowerShell を呼ぶ 推奨

for /f "usebackq delims=" %%d in (`powershell -NoProfile -Command "Get-Date -Format yyyyMMdd_HHmmss"`) do set "STAMP=%%d"
echo %STAMP%

20260825_004102

書式を -Format で明示するため、地域設定に一切依存しません。読んで意図が分かるのも利点です。欠点は PowerShell の起動コストで、1回あたり数百ミリ秒かかります。ループの中で毎回呼ぶのではなく、スクリプトの先頭で1回だけ取得して変数に入れます。

方法2: wmic を使う 非推奨

for /f "tokens=2 delims==" %%d in ('wmic os get localdatetime /value 2^>nul ^| find "="') do set "LDT=%%d"
set "STAMP=%LDT:~0,8%_%LDT:~8,6%"

取得できる生の値は 20260825004102.484000+540 です。地域設定に依存しない固定書式なので、かつては定番でした。しかし wmic は非推奨となり、将来の Windows で削除される予定です。Windows 11 の新しい版（ビルド 26300 で確認）には、すでにありません。wmic が無い環境では LDT が未定義のまま上の部分取得が展開され、20260825_004102 ではなく崩れた文字列になります。新規に書くなら方法1を選びます。

また for /f で読むと値の末尾に余分な CR が混入します。上のように部分取得（%LDT:~0,8%）で必要な桁だけ切り出せば影響を避けられますが、%LDT% をそのまま使うとファイル名やパスが壊れます。

方法3: %DATE% と %TIME% を加工する

set "D=%DATE:/=%"
rem 先頭の空白を 0 に置換してから、コロンとピリオドを削除する
set "T=%TIME: =0%"
set "T=%T::=%"
set "T=%T:.=%"
set "STAMP=%D%_%T:~0,6%"

外部プロセスを起動しないので高速です。%TIME: =0%（空白を 0 に置換）が先頭空白への対策になっています。ただし地域設定に依存するため、配布するバッチには向きません。自分の PC 専用のスクリプトに限って使います。

まとめ

実行環境を固定する

カレントディレクトリは信用できない

相対パスの起点は実行時のカレントディレクトリであり、バッチが置かれている場所ではありません。呼び出し方によって変わります。

先頭で pushd する

@echo off
rem このバッチの場所へ移動する。失敗したらすぐ終了する
pushd "%~dp0" || exit /b 1

rem …処理…

popd

cd ではなく pushd を使う理由は、共有フォルダ（UNC パス）でも動くことです。cd は \\server\share\... をカレントにできず、UNC パスはサポートされません。Windows ディレクトリを既定で使用します。 というメッセージを出して C:\Windows に留まります。pushd は UNC パスに一時的なドライブレターを割り当てるため、そのまま移動できます。

共有フォルダ上のバッチをダブルクリックしたときの表示は次のとおりです（1行目は開始時のカレント）。上が日本語環境、下が英語環境の公式のロケール出力です。

'\\server\share\tools'
上記の現在のディレクトリで CMD.EXE を開始しました。
UNC パスはサポートされません。Windows ディレクトリを既定で使用します。

'\\server\share\tools'
CMD.EXE was started with the above path as the current directory.
UNC paths are not supported.  Defaulting to Windows directory.

pushd で割り当てたドライブは popd で解放されます。必ず対で書いてください。

カレントを変えたくない場合

パスを %~dp0 で明示します。

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

rem 同じフォルダの別のバッチを呼ぶ
call "%~dp0sub.cmd"

%~dp0 の末尾には \ が付いているので、連結は "%~dp0config.ini" です。"%~dp0\config.ini" と書くと \ が二重になります。多くの場合は動いてしまいますが、UNC パスや一部の API で失敗します。

管理者権限が必要な場合

バッチ自身で権限を昇格させることはできません。判定して案内するのが現実的です。

rem 管理者権限があるかを確認する（net session は管理者でないと失敗する）
net session >nul 2>&1 || (
    echo [エラー] このバッチは管理者として実行してください
    echo         右クリック ^> 管理者として実行
    pause
    exit /b 1
)

エラー処理の型

例外がないので、1行ごとに書く

第1回で見たとおり、失敗しても次の行は実行されます。止めたい箇所には明示的に書く必要があります。

基本形

@echo off
setlocal enabledelayedexpansion
pushd "%~dp0" || exit /b 1

rem --- 事前確認: 実行する前に弾けるものは弾く ---
if not exist "%SRC%" (
    echo [エラー] コピー元が見つかりません: %SRC%
    exit /b 1
)

rem --- 各コマンドに失敗時の処理を付ける ---
md "%DSTDIR%" 2>nul
copy "%SRC%" "%DSTDIR%\" >nul || (
    echo [エラー] コピーに失敗しました
    exit /b 1
)

echo 完了しました
exit /b 0

md "%DSTDIR%" 2>nul は「すでにあってもエラーにしない」書き方です。md は既存フォルダに対して失敗しますが、この場合は失敗しても構わないので、エラー出力だけ捨てて続行します。

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

rem robocopy は成功でも 0 以外を返すので || では判定できない
robocopy "%SRC%" "%DST%" /e /r:1 /w:1
if errorlevel 8 (
    echo [エラー] robocopy が失敗しました
    exit /b 1
)

後始末を確実に通す

try/finally がないので、終了処理を1か所に集めて goto で合流させます。

@echo off
setlocal enabledelayedexpansion
pushd "%~dp0" || exit /b 1

set "RC=0"

if not exist "%SRC%" (
    echo [エラー] 見つかりません: %SRC%
    set "RC=1"
    goto :finish
)

call :main
set "RC=!errorlevel!"

:finish
rem --- 成功・失敗にかかわらずここを通る ---
if exist "%TMPFILE%" del "%TMPFILE%"
endlocal & set "RC=%RC%"
popd
exit /b %RC%

:main
rem 実際の処理。失敗したら exit /b で 0 以外を返す
exit /b 0

endlocal & set "RC=%RC%" は、endlocal で破棄される前に RC の値を持ち出すための定型です。この行は解析時に %RC% が展開されるため、endlocal の実行より先に値が確定します。

ログ出力

リダイレクトの順序に注意

2>&1 は「その時点で標準出力が向いている先」を意味します。先に >> log.txt でファイルへ向けてから 2>&1 と書く必要があります。

サブルーチン全体の出力をログへ回す

rem call の行にリダイレクトを付けると、:main 内のすべての出力が対象になる
call :main >> "%LOGFILE%" 2>&1
set "RC=%errorlevel%"

1行ずつ >> "%LOGFILE%" を書く必要がなくなります。無人実行するバッチではこの形が便利です。

画面とログの両方に出す

tee がないので、素直に2回書きます。

call :log "処理を開始します"
goto :eof

:log
echo [%DATE% %TIME%] %~1
echo [%DATE% %TIME%] %~1 >> "%LOGFILE%"
goto :eof

日付ごとにログを分ける

@echo off
setlocal enabledelayedexpansion
pushd "%~dp0" || exit /b 1

rem 日付を確実に取得する（3章の方法1）
for /f "usebackq delims=" %%d in (`powershell -NoProfile -Command "Get-Date -Format yyyyMMdd"`) do set "TODAY=%%d"

set "LOGDIR=%~dp0log"
set "LOGFILE=!LOGDIR!\job_!TODAY!.log"
if not exist "!LOGDIR!" md "!LOGDIR!"

call :log "==== 処理を開始します ===="
call :main >> "!LOGFILE!" 2>&1
set "RC=!errorlevel!"

if "!RC!"=="0" (
    call :log "==== 正常終了しました ===="
) else (
    call :log "==== 異常終了しました 終了コード=!RC! ===="
)

endlocal & set "RC=%RC%"
popd
exit /b %RC%

:main
echo 本処理を実行中...
exit /b 0

:log
echo [%DATE% %TIME%] %~1
echo [%DATE% %TIME%] %~1 >> "!LOGFILE!"
goto :eof

引数処理とヘルプ表示

引数チェックの定型

@echo off
setlocal enabledelayedexpansion

rem --- ヘルプの要求と引数なしを同じ扱いにする ---
if "%~1"=="" goto :usage
if "%~1"=="/?" goto :usage
if /i "%~1"=="-h" goto :usage
if /i "%~1"=="--help" goto :usage

set "TARGET=%~1"
set "OPTION=%~2"

if not exist "!TARGET!" (
    echo [エラー] 対象が見つかりません: !TARGET!
    exit /b 1
)

rem …処理…
exit /b 0

:usage
echo 使い方: %~nx0 ^<対象パス^> [オプション]
echo.
echo   対象パス    処理するファイルまたはフォルダ
echo   オプション  省略可
exit /b 1

%~nx0 でファイル名を出しているので、バッチをリネームしてもヘルプが正しく表示されます。< と > はリダイレクト記号なので ^ でエスケープします。

オプションを解析する

本格的な引数解析が必要なら、shift でループします。shift は %0 もずらすため、解析のあとで使い方に %~nx0 を出すと名前が崩れます。名前は解析の前に変数へ控えます（落とし穴 #15）。

set "VERBOSE="
set "TARGET="

:parse
if "%~1"=="" goto :parse_done
if /i "%~1"=="-v" (
    set "VERBOSE=1"
) else if /i "%~1"=="-o" (
    rem 次の引数を値として取る
    set "OUTPUT=%~2"
    shift
) else (
    set "TARGET=%~1"
)
shift
goto :parse

:parse_done
if not defined TARGET (
    echo [エラー] 対象を指定してください
    exit /b 1
)

引数の引用符の扱い

この定型にしておけば、呼び出し側が囲んでいても囲んでいなくても同じコードで扱えます。値に引用符を含めないのが、混乱を避ける唯一の方法です。

テンプレートと配布時の注意

3種類のテンプレート

docs\samples\templates\ に用途別に3つ置いてあります。用途が違うと必要な定型も違うため、1つに全部詰め込んでいません。

tool.cmd の骨格

@echo off
rem --- カレントをこのファイルの場所に固定する（UNC パスでも動く pushd を使う） ---
pushd "%~dp0" || exit /b 1

rem --- 変数の変更をこのスクリプト内に閉じ、遅延展開を有効にする ---
setlocal enabledelayedexpansion

rem --- 引数チェック ---
if "%~1"=="" goto :usage
if /i "%~1"=="/?" goto :usage

set "TARGET=%~1"

if not exist "!TARGET!" (
    echo [エラー] 対象が見つかりません: !TARGET!
    set "RC=1"
    goto :finish
)

rem --- 本処理 ---
call :main
set "RC=!errorlevel!"

if "!RC!"=="0" (
    echo 完了しました。
) else (
    echo [エラー] 処理に失敗しました。終了コード: !RC!
)

:finish
rem --- 後始末。RC を endlocal の外へ持ち出してから戻る ---
endlocal & set "RC=%RC%"
popd
exit /b %RC%

:main
rem ここに処理を書く。失敗したら exit /b で 0 以外を返す
exit /b 0

:usage
echo 使い方: %~nx0 ^<対象パス^>
popd
exit /b 1

この20行が、この回で扱ったすべての対策を含んでいます。次に書くバッチはこれをコピーして :main の中を埋めるところから始められます。

配布時のチェックリスト

その他の落とし穴

サンプルは docs\samples\03\ にあります。

バッチの限界とシリーズのまとめ

バッチで書くべきではない4条件

次のどれかに当てはまったら、バッチをやめて別の道具を使う判断をします。

第2回のデモで「拡張子ごとに変数を用意する」形になった時点が、まさにこの兆候でした。変数名を並べ始めたら限界が近いという感覚を持っておくと判断しやすくなります。

逆にバッチが向いているのは、数十行で終わる決まった手順を、環境構築なしで実行したいときです。ランチャー、定型的なファイル操作、他のツールの呼び出し。この範囲に収めるかぎり、バッチは今でも最も手軽な選択肢です。

シリーズ全体のまとめ

3回を通して繰り返し出てきたのは、「バッチには暗黙の前提が多く、その前提は環境によって変わる」という一点です。テンプレートの冒頭数行は、そのすべてを明示的に固定するためにあります。

この先の参照先

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