【bat】EXIT /B 完全解説｜/B オプション・戻り値 0/1・ウィンドウを閉じない仕組みと活用パターン

バッチファイルで処理を終了するとき、EXIT と EXIT /B はまったく異なる動作をします。「/B を付けるとウィンドウが閉じない」「0 は成功、1 はエラー」という基本から、戻り値の設計・ERRORLEVEL の受け取り方・タスクスケジューラ連携まで、EXIT /B のすべてを体系的に解説します。

EXIT /B とは？ /B オプションの意味

EXIT /B の /B は 「Batch（バッチ）の現在のコンテキストだけ終了する」 オプションです。

EXIT /B の構文

EXIT [/B] [exitCode]

EXIT /B 0 と EXIT /B 1 の意味（戻り値の慣習）

戻り値（終了コード）には以下の慣習があります。これは Windows のシステムコマンドや多くのプログラムが従う標準です。

@echo off
setlocal

:: 成功パターン
CALL :Process
if %ERRORLEVEL% EQU 0 (
  echo 処理成功
) else (
  echo 処理失敗（コード: %ERRORLEVEL%）
)
GOTO :EOF

:Process
  xcopy /Y "source*" "dest" >nul 2>&1
  if %ERRORLEVEL% NEQ 0 EXIT /B 1
  EXIT /B 0

ERRORLEVEL で戻り値を受け取る

EXIT /B N でセットした値は呼び出し元で %ERRORLEVEL% または IF ERRORLEVEL で受け取れます。

方法1：%ERRORLEVEL% 変数で比較（推奨）

CALL :MyFunc
if %ERRORLEVEL% EQU 0 echo 成功
if %ERRORLEVEL% EQU 1 echo 失敗
if %ERRORLEVEL% EQU 2 echo 引数エラー

方法2：IF ERRORLEVEL N（旧構文・注意が必要）

CALL :MyFunc
IF ERRORLEVEL 2 echo 2以上
IF ERRORLEVEL 1 echo 1以上（2以上も含む！）
IF ERRORLEVEL 0 echo 0以上（常に真！）

方法3：ERRORLEVEL を変数に退避してから比較（最安全）

CALL の直後に別コマンドを挟むと ERRORLEVEL が上書きされます。安全のため変数に退避しましょう。

CALL :MyFunc
set RC=%ERRORLEVEL%
:: echo などのコマンドが ERRORLEVEL を変更しても RC は保持される
echo 戻り値: %RC%
if %RC% EQU 0 echo 成功処理
if %RC% NEQ 0 echo エラー処理（code=%RC%）

EXIT /B と GOTO :EOF の違い

どちらも「現在のコンテキストを終了して戻る」命令ですが、動作に微妙な差があります。

戻り値を活用した設計パターン

パターン1：成否だけを返す（0/1）

最もシンプルな設計。成功=0・失敗=1 のみ。

:CopyFiles
  xcopy /Y "%~1" "%~2" >nul 2>&1
  if %ERRORLEVEL% NEQ 0 EXIT /B 1
  EXIT /B 0

パターン2：複数の失敗理由を区別する（0/1/2/3）

処理の失敗原因を呼び出し元が判断できるよう、コードを細分化します。

:BackupFile
  :: 引数チェック
  if "%~1"=="" EXIT /B 2
  :: ファイル存在チェック
  if not exist "%~1" EXIT /B 3
  :: バックアップ実行
  copy "%~1" "%~1.bak" >nul 2>&1
  if %ERRORLEVEL% NEQ 0 EXIT /B 1
  EXIT /B 0

:: 呼び出し側
CALL :BackupFile "C:datalog.txt"
set RC=%ERRORLEVEL%
if %RC% EQU 0 echo バックアップ成功
if %RC% EQU 1 echo コピー失敗
if %RC% EQU 2 echo 引数が未指定
if %RC% EQU 3 echo ファイルが見つからない

パターン3：別バッチを CALL して戻り値を受け取る

サブルーチンだけでなく、別ファイルのバッチを CALL したときも同様に戻り値を受け取れます。

:: main.bat
@echo off
CALL process.bat
set RC=%ERRORLEVEL%
if %RC% NEQ 0 (
  echo process.bat が失敗しました（code: %RC%）
  EXIT /B 1
)
echo 全処理完了
EXIT /B 0

:: process.bat
@echo off
echo 処理中...
:: 何らかの理由で失敗
EXIT /B 1

負の値・特殊ケース

EXIT /B に負の値を渡すと？

EXIT /B に負の値を渡すと、ERRORLEVEL には 符号なし 32bit 整数として格納されます。

EXIT /B -1
:: → ERRORLEVEL = 4294967295 (0xFFFFFFFF)

EXIT /B -2
:: → ERRORLEVEL = 4294967294

タスクスケジューラ・CI/CD との連携

バッチファイルを定期実行する場合、EXIT /B で返した終了コードが外部ツールに伝わります。

タスクスケジューラ

:: backup.bat の最後
if %ERRORLEVEL% NEQ 0 EXIT /B 1
EXIT /B 0

タスクスケジューラでは「最後の実行結果」に終了コードが表示されます。0 以外はエラー扱いになり、アラート設定が可能です。

Jenkins・GitHub Actions など CI/CD

:: Jenkins で bat ステップとして実行する場合
@echo off
CALL build.bat
if %ERRORLEVEL% NEQ 0 (
  echo BUILD FAILED
  EXIT /B 1
)
echo BUILD SUCCESS
EXIT /B 0

CI ツールはプロセスの終了コードが 0 以外の場合にビルドを「失敗」として扱います。EXIT /B 0 を書き忘れると、直前コマンドの ERRORLEVEL によって誤って失敗扱いになるケースに注意してください。

よくあるハマりポイント一覧

よくある質問（FAQ）

@echo off
echo 処理完了
PAUSE
EXIT /B 0

cmd /k "C:scriptsmybatch.bat"

まとめ

EXIT /B は「ウィンドウを閉じずにコードを返す」というシンプルな命令ですが、数値の有無・ERRORLEVEL の比較方法・負の値の罠・CALL の有無など、正確に使いこなすには細かい知識が必要です。今回解説したパターンを参考に、戻り値を活用した堅牢なバッチファイルを作成してください。