【bat】setlocal enabledelayedexpansion 完全ガイド｜遅延展開が展開されない原因・デメリット・文字切り出し・ERRORLEVEL保存

@echo off
set COUNT=0

for /l %%i in (1,1,5) do (
    set /a COUNT+=1
    echo COUNT = %COUNT%   &:: 常に 0 と表示される！
)
echo 最終値: %COUNT%   &:: ここは正しく 5

書き方	ループ内の echo 出力	理由
%COUNT%	0, 0, 0, 0, 0	パース時に 0 で固定される
!COUNT!	1, 2, 3, 4, 5	実行時に毎回展開される

なぜ 0 になるのか
for ブロック全体が実行される前に %COUNT% が展開されます。その時点の COUNT は 0 なので、ループ中ずっと echo COUNT = 0 というコマンドとして解釈されます。

@echo off
setlocal enabledelayedexpansion

set COUNT=0

for /l %%i in (1,1,5) do (
    set /a COUNT+=1
    echo COUNT = !COUNT!   &:: 1, 2, 3, 4, 5 と正しく表示
)

endlocal

記法	展開タイミング	ブロック内での挙動
%VAR%	パース時（実行前）	ブロック入口の値で固定される
!VAR!	実行時（その行）	最新の値が参照される

:: 方法1: setlocal で有効化（スコープ内のみ有効）
setlocal enabledelayedexpansion
:: ... 処理 ...
endlocal

:: 方法2: cmd /v:on で起動（セッション全体で有効）
cmd /v:on /c "echo !COMPUTERNAME!"

:: 方法3: ブロック内だけ一時的に有効・無効を切り替え
setlocal enabledelayedexpansion
:: !が含まれるテキストを扱いたい部分だけ disableに
setlocal disabledelayedexpansion
set MSG=Hello! World
endlocal & set MSG=%MSG%   &:: 値を外のスコープへ引き継ぐ
echo !MSG!

@echo off
setlocal enabledelayedexpansion

set STR=20260313_backup.zip

:: 先頭4文字（年）
echo 年: !STR:~0,4!          &:: 2026

:: 4文字目から2文字（月）
echo 月: !STR:~4,2!          &:: 03

:: 末尾4文字
echo 末尾: !STR:~-4!         &:: .zip

:: 末尾4文字を除いた部分
echo 拡張子なし: !STR:~0,-4!   &:: 20260313_backup

:: ループ内での文字切り出し（遅延展開が必要な場面）
for %%f in (C:logs*.log) do (
    set FNAME=%%~nf
    :: ファイル名の先頭8文字（日付部分）を取得
    echo 日付部分: !FNAME:~0,8!
)

endlocal

記法	意味	例（STR=ABCDEFGH）
!STR:~0,4!	先頭から4文字	ABCD
!STR:~2,3!	2文字目から3文字	CDE
!STR:~-3!	末尾から3文字	FGH
!STR:~0,-2!	末尾2文字を除く	ABCDEF
!STR:~3!	3文字目以降すべて	DEFGH

ポイント
!STR:~N,M! はループや if ブロック内で 動的に決まる変数を切り出すときに使います。ループ外の切り出しなら %STR:~N,M% で十分です。

@echo off
xcopy C:src D:dst /D /Y

if %ERRORLEVEL% neq 0 (
    :: ここで echo を実行すると ERRORLEVEL が 0 にリセットされる
    echo エラーが発生しました: %ERRORLEVEL%   &:: 常に 0 を表示してしまう
    exit /b %ERRORLEVEL%              &:: 0 で終了してしまう
)

@echo off
setlocal enabledelayedexpansion

xcopy C:src D:dst /D /Y
set RC=!ERRORLEVEL!   &:: 実行直後に保存

if !RC! neq 0 (
    echo エラーコード: !RC!   &:: 正しい値を参照できる
    echo [%DATE% %TIME%] xcopy 失敗 code=!RC! ^>> error.log
    exit /b !RC!           &:: 正しいコードで終了
)

echo 正常終了
endlocal

ベストプラクティス
コマンド実行直後の次の行で set RC=!ERRORLEVEL! として変数に保存し、以降は !RC! を参照するパターンが最も安全です。

setlocal enabledelayedexpansion
set MSG=Hello! World
echo !MSG!   &:: 出力: Hello  ← ! 以降が消える

:: 対策: ^ でエスケープ
set MSG=Hello^! World
echo !MSG!   &:: 出力: Hello! World

setlocal enabledelayedexpansion
for %%f in ("C:data
eport!2026.csv") do (
    set FP=%%f
    echo !FP!   &:: ! 以降が消える可能性
)

:: 対策: %%f を直接使う（遅延展開変数を経由しない）
for %%f in ("C:data
eport!2026.csv") do echo %%f

setlocal enabledelayedexpansion
set RESULT=100
:: endlocal と同じ行で set すると値が外に渡せる
endlocal & set RESULT=%RESULT%   &:: %RESULT% は endlocal 前に展開される
echo %RESULT%   &:: 100 が出力される

setlocal enabledelayedexpansion   &:: スコープ1: 有効
    setlocal disabledelayedexpansion  &:: スコープ2: 無効
    set MSG=Hello! World            &:: ! を安全に扱える
    endlocal & set MSG=%MSG%        &:: スコープ1 に戻す
echo !MSG!                        &:: スコープ1では ! が有効
endlocal

setlocal enabledelayedexpansion
set MSG=Hello^! World

:: NG: call 経由で ! 含む値を渡すと二重展開で壊れる
call :SHOW !MSG!      &:: "Hello" だけ渡される

:: OK: 一時変数に入れて %VAR% で渡す（call は即時展開）
set TMP=!MSG!
call :SHOW %TMP%       &:: 正しく渡せる
exit /b 0
:SHOW
echo 受け取った値: %~1
exit /b 0

対策の指針
! を含む可能性のある外部入力・ファイル名・パスは、遅延展開スコープに入れる前に setlocal disabledelayedexpansion で保護するか、^^! でエスケープしましょう。

デメリット	症状	対策
! 文字の欠落	感嘆符以降の文字列が消える	^! でエスケープ / disable で囲む
パスの ! 欠落	! 含むファイル名が壊れる	%%f を直接使い変数経由しない
endlocal で消える	スコープ外で変数が未定義	endlocal & set VAR=%VAR%
ネストの混乱	enable/disable の状態が不明確	コメントで状態を明記する
CALL の複雑化	! 含む値の CALL 渡しが難解	disable スコープで処理してから渡す

:: 確認: 遅延展開が有効かテスト
setlocal enabledelayedexpansion
set X=TEST
echo !X!   &:: TEST と表示されれば有効

xcopy src dst
set RC=!ERRORLEVEL!   &:: ← 必ず次の行で即保存
:: 以降は !RC! を使う

場面	使うべき記法
ループ内でカウンタを参照	!COUNT!
if ブロック内で変数を更新して参照	!VAR!
ERRORLEVEL を安全に保存	set RC=!ERRORLEVEL!
ループ内でファイル名を切り出す	!FNAME:~0,8!
! を含む文字列を安全に扱う	disabledelayedexpansion スコープで処理
スコープ外に値を持ち出す	endlocal & set VAR=%VAR%

関連記事
変数展開がうまくいかない原因をトラブルシューティングの観点から詳しく知りたい方は 【bat】変数展開が思った通りに動かない原因と修正方法 もご覧ください。