【bat】バッチファイルの変数展開トラブル完全解決ガイド｜%と!の違い・FORループ・特殊文字・スコープまで徹底解説

@echo off
set COUNT=0
for %%A in (1 2 3) do (
    set /a COUNT+=1
    echo COUNT=%COUNT%
)
echo 最終値: %COUNT%
rem 出力:
rem COUNT=0
rem COUNT=0
rem COUNT=0
rem 最終値: 3  ← ループ後は正しい

@echo off
setlocal enabledelayedexpansion
set COUNT=0
for %%A in (1 2 3) do (
    set /a COUNT+=1
    echo COUNT=!COUNT!
)
echo 最終値: !COUNT!
endlocal
rem 出力:
rem COUNT=1
rem COUNT=2
rem COUNT=3
rem 最終値: 3

@echo off
setlocal enabledelayedexpansion
set X=before
if 1==1 (
    set X=after
    echo %%展開: %X%
    echo !展開:  !X!
)
rem 出力:
rem %展開: before  ← ブロック読み込み時の値
rem !展開:  after   ← 実行時の最新値

@echo off
set COUNT=0
for %%A in (1 2 3) do (
    set /a COUNT+=1
rem call を挟むと再展開される
    call echo COUNT=%%COUNT%%
)
rem %%COUNT%% は call 実行時に %COUNT% として展開され
rem さらに COUNT の値として展開される

@echo off
rem バッチファイル内で % を文字として出力する
echo 達成率: 100%%
rem 出力: 達成率: 100%

rem FORのループ変数はバッチファイル内では %%F
for %%F in (*.txt) do echo %%~nxF

rem コマンドラインから直接実行する場合は %F（シングル）
rem for %F in (*.txt) do echo %~nxF

@echo off
setlocal enabledelayedexpansion

rem 方法1: setlocal DisableDelayedExpansion で一時的に無効化
for /f "usebackq delims=" %%L in ("input.txt") do (
    set "LINE=%%L"
    setlocal disabledelayedexpansion
    echo %LINE%
    endlocal
)

rem 方法2: ^^! でエスケープ（^ を2つ重ねる）
echo This is a test^^!
rem 出力: This is a test!

@echo off
rem set "VAR=値" 形式で特殊文字を安全に格納
set "FILE=C:\work\report(2024).txt"
set "MSG=処理完了 & バックアップ完了"

rem 変数展開時はクォートで囲む
echo "%FILE%"
echo "%MSG%"

rem echo で特殊文字を含む文字列を出力する場合は ^ でエスケープ
echo ^(test^) ^& done
rem 出力: (test) & done

@echo off
rem NG1: 行末スペースが変数に含まれる
set VAR=hello   
if "%VAR%"=="hello" echo 一致 
rem → "hello   " == "hello" は偽になる

rem NG2: 特殊文字が変数に含まれる場合に誤解析
set MSG=処理完了 & echo NG
rem → & の後が別コマンドとして実行される

rem OK: set "VAR=値" 形式
set "VAR=hello"
set "MSG=処理完了 & バックアップ完了"
if "%VAR%"=="hello" echo 一致  ← 正しく動作

@echo off
call :get_result RESULT
echo 結果: %RESULT%
exit /b

:get_result
setlocal
set "TEMP_RESULT=計算結果ABC"
rem endlocal と set を & で同一行に書く
rem endlocal が実行された瞬間に %%TEMP_RESULT%% が展開される
endlocal & set "%~1=%TEMP_RESULT%"
exit /b
rem 出力: 結果: 計算結果ABC

@echo off
rem NG: VAR が未定義の場合は "%VAR%" → "" になり空判定できるが
rem     VAR に特殊文字（"や&など）が含まれると構文エラーになる
if "%VAR%"=="" echo 空です

rem OK1: [] で囲む方法（特殊文字に強い）
if [%VAR%]==[] echo 空または未定義です

rem OK2: not defined で未定義チェック
if not defined VAR echo 未定義です

rem OK3: 遅延展開で空チェック
setlocal enabledelayedexpansion
if "!VAR!"=="" echo 空または未定義です
endlocal

@echo off
setlocal enabledelayedexpansion
set COUNT=0
set "TOTAL=0"

rem ファイルの各行を読みながらカウント
for /f "usebackq delims=" %%L in ("data.txt") do (
    set /a COUNT+=1
    echo 行 !COUNT!: %%L
)
echo 合計行数: !COUNT!
endlocal

@echo off
setlocal enabledelayedexpansion

for /f "usebackq delims=" %%L in ("input.txt") do (
    set "LINE=%%L"
rem ! を含む行を echo する場合は DisableDelayedExpansion に切り替え
    setlocal disabledelayedexpansion
    echo %LINE%
    endlocal
)
endlocal

@echo off
setlocal enabledelayedexpansion
set "DIR=C:\work"

rem NG: バッククォート内は !VAR! が展開されない場合がある
for /f "usebackq delims=" %%F in (`dir /b "!DIR!"`) do echo %%F

rem OK: 事前に変数に展開してから使う
set "CMD=dir /b "%DIR%""
for /f "usebackq delims=" %%F in (`!CMD!`) do echo %%F

rem または %VAR% で先に展開しておく（ブロック外なら動く）
for /f "usebackq delims=" %%F in (`dir /b "%DIR%"`) do echo %%F

@echo off
setlocal enabledelayedexpansion

rem set /a は !VAR! も %VAR% も両方使える（どちらでも最新値を参照）
set NUM=10
for %%i in (1 2 3) do (
    set /a NUM+=%%i
    echo NUM=!NUM!
)
rem 出力: NUM=11, NUM=13, NUM=16

@echo off
rem 1. @echo on でコマンド展開後の内容を表示
@echo on
set X=hello world
echo %X%
@echo off
rem → [echo hello world] と展開後が表示される

rem 2. echo でブラケット付き表示（スペースを視覚化）
set "VAR=  spaced  "
echo [%VAR%]
rem → [  spaced  ] ← 前後のスペースが見える

rem 3. cmd /v:on でコマンドラインから遅延展開を一時テスト
rem cmd /v:on /c "set X=test & echo !X!"

rem 4. 遅延展開で変数の内容を確認
setlocal enabledelayedexpansion
set "TARGET="
echo [!TARGET!]
rem 出力: [] ← 空変数の確認
endlocal

@echo off
setlocal enabledelayedexpansion

if "%~1"=="" (
    echo 使い方: search_count.bat "キーワード" "ファイルパス"
    exit /b 1
)

set "KEYWORD=%~1"
set "FILEPATH=%~2"
set COUNT=0

if not exist "%FILEPATH%" (
    echo エラー: ファイルが見つかりません: %FILEPATH%
    exit /b 1
)

echo 検索キーワード: !KEYWORD!
echo 対象ファイル: !FILEPATH!
echo ---

for /f "usebackq delims=" %%L in ("!FILEPATH!") do (
    echo %%L | findstr /i "!KEYWORD!" >nul
    if not errorlevel 1 (
        set /a COUNT+=1
        echo 行 !COUNT!: %%L
    )
)

echo ---
echo ヒット数: !COUNT! 件
endlocal