【bat】exit /bの使い方｜ERRORLEVEL・終了コードを返す方法

batで処理結果を呼び出し元へ返すなら、基本は exit /b 終了コード です。exit だけを書くとコマンドプロンプトごと閉じることがありますが、exit /b は現在のバッチやサブルーチンだけを終了し、ERRORLEVEL に成功・失敗の番号を残せます。

この記事では exit /b 0 と exit /b 1 の違い、ERRORLEVEL の受け取り方、タスクスケジューラで失敗扱いにする終了コード、GOTO :EOF との使い分けまで、実務で迷いやすいポイントを整理します。

まず使う書き方早見表

@echo off
setlocal

call :main
set "RC=%ERRORLEVEL%"

if not "%RC%"=="0" (
    echo [ERROR] 処理に失敗しました。終了コード=%RC%
    exit /b %RC%
)

echo [OK] 処理が完了しました。
exit /b 0

:main
rem ここに実処理を書く
exit /b 0

目的別ショートカット

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

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

EXIT /B の構文

EXIT [/B] [exitCode]

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

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

@echo off
setlocal

call :Process
set "RC=%ERRORLEVEL%"

if "%RC%"=="0" (
    echo 処理成功
) else (
    echo 処理失敗（終了コード: %RC%）
)
exit /b %RC%

:Process
xcopy /Y "C:\source\*" "D:\dest\" >nul 2>&1
if errorlevel 1 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 戻り値: %RC%
if "%RC%"=="0" echo 成功処理
if not "%RC%"=="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:\data\log.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

実務で迷ったときの終了コード設計

終了コードは細かく増やしすぎると運用が面倒になります。まずは 0=成功、1=一般的な失敗、2=引数や設定の不備、3=入力ファイルなし くらいに分けると、ログやタスクスケジューラの結果から原因を追いやすくなります。

@echo off
setlocal

if "%~1"=="" (
    echo [ERROR] 引数が指定されていません。
    exit /b 2
)

if not exist "%~1" (
    echo [ERROR] 入力ファイルが見つかりません: "%~1"
    exit /b 3
)

rem 実処理
echo [OK] 入力ファイルを確認しました: "%~1"
exit /b 0

タスクスケジューラ・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 によって誤って失敗扱いになるケースに注意してください。

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

あわせて確認したい関連記事

• バッチファイル（bat）の目的別記事一覧
• エラー時に処理を中断・終了する方法
• ファイル存在チェックの書き方
• schtasksコマンドでタスクスケジューラを制御する方法
• バッチファイルで実行ログを出力する方法

よくある質問（FAQ）

まとめ

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