【bat】バッチファイルの環境変数完全ガイド｜set・setx・遅延展開・文字列操作・スコープまで徹底解説

@echo off
setlocal

:: 変数を設定（ダブルクォートで囲む形式を推奨）
set "NAME=山田太郎"
set "AGE=30"
set "DIR=C:\work"

:: 変数を参照
echo 名前: %NAME%
echo 年齢: %AGE%
echo 作業フォルダ: %DIR%

endlocal

@echo off
setlocal

set "MYVAR=hello"
echo 設定後: [%MYVAR%]

:: 変数を削除（右辺を空にする）
set "MYVAR="
echo 削除後: [%MYVAR%]

:: 未定義・空チェック
if not defined MYVAR (
    echo MYVAR は未定義または空です。
)

:: defined は「=」以降が空でも defined と判定されない
set "FLAG="
if defined FLAG (
    echo FLAG は定義済み
) else (
    echo FLAG は未定義
)

endlocal

@echo off
setlocal

:: 四則演算
set /a "RESULT = 10 + 3"
echo 10 + 3 = %RESULT%

set /a "RESULT = 10 - 3"
echo 10 - 3 = %RESULT%

set /a "RESULT = 10 * 3"
echo 10 * 3 = %RESULT%

set /a "RESULT = 10 / 3"
echo 10 / 3 = %RESULT%   ← 整数除算（小数点切り捨て）= 3

:: 剰余（余り）
set /a "MOD = 10 %% 3"
echo 10 mod 3 = %MOD%    ← 1

:: インクリメント（カウンタ）
set /a "COUNT = 0"
set /a "COUNT += 1"
set /a "COUNT += 1"
echo COUNT = %COUNT%     ← 2

:: 累乗はできない（代わりに掛け算を繰り返す）
set /a "SQUARE = 5 * 5"
echo 5^2 = %SQUARE%

endlocal

@echo off
setlocal

:: ユーザーに入力を求める
set /p "FOLDER=対象フォルダのパスを入力してください: "

:: 入力チェック
if not defined FOLDER (
    echo [ERROR] 入力がありませんでした。
    exit /b 1
)

if not exist "%FOLDER%" (
    echo [ERROR] フォルダが存在しません: %FOLDER%
    exit /b 1
)

echo [OK] %FOLDER% を処理します...
endlocal

@echo off
setlocal

set "COUNT=0"
for %%F in (*.txt) do (
    set /a "COUNT += 1"
    echo %%F を処理中... COUNT=%COUNT%    ← 常に 0 と表示される
)
echo 合計: %COUNT%    ← 最終的に 0 のまま

endlocal

@echo off
setlocal enabledelayedexpansion

set "COUNT=0"
for %%F in (*.txt) do (
    set /a "COUNT += 1"
    echo %%F を処理中... COUNT=!COUNT!    ← 正しく更新される
)
echo 合計: !COUNT!

endlocal

@echo off
setlocal

set "STR=HelloWorld"

:: %VAR:~開始位置,文字数%
echo 先頭から5文字: %STR:~0,5%       ← Hello
echo 6文字目以降:   %STR:~5%         ← World
echo 末尾3文字:     %STR:~-3%        ← rld
echo 末尾から3文字目までの5文字: %STR:~-8,5%  ← lloWo

:: 日付から年月日を取り出す例（ロケール依存に注意）
echo 年: %DATE:~0,4%
echo 月: %DATE:~5,2%
echo 日: %DATE:~8,2%

endlocal

@echo off
setlocal

set "PATH_STR=C:\work\data\file.txt"

:: スラッシュに変換（\→/）
set "UNIX_PATH=%PATH_STR:\=/%"
echo Unix形式: %UNIX_PATH%    ← C:/work/data/file.txt

:: 特定文字を削除（置換先を空にする）
set "CLEAN=%PATH_STR:.txt=%"
echo 拡張子削除: %CLEAN%      ← C:\work\data\file

:: スペースを削除
set "STR_WITH_SPACE= hello world "
set "NO_SPACE=%STR_WITH_SPACE: =%"
echo スペース削除: [%NO_SPACE%]  ← [helloworld]

endlocal

@echo off
setlocal

set "STR=HelloWorld"

:: PowerShellで文字列長を取得
for /f %%L in ('powershell -command "\"%STR%\".Length"') do (
    set "LEN=%%L"
)
echo 文字列長: %LEN%    ← 10

endlocal

@echo off
set "GLOBAL_VAR=グローバル"

call :sub_routine
echo 呼び出し後: %GLOBAL_VAR%    ← グローバル（変わっていない）
echo サブ変数:   %LOCAL_VAR%     ← （空。endlocalで消えた）

pause
goto :EOF

:sub_routine
setlocal
set "LOCAL_VAR=ローカル"
set "GLOBAL_VAR=書き換え試み"
echo サブ内: %GLOBAL_VAR%    ← 書き換え試み（setlocal内では有効）
endlocal
goto :EOF

@echo off

:: 現在のユーザーに環境変数を設定（管理者権限不要）
setx MYAPP_HOME "C:\tools\myapp"

:: システム全体（全ユーザー）に設定（管理者権限が必要）
setx SHARED_DIR "\\server\shared" /M

echo 設定完了。新しいコマンドプロンプトから有効になります。

@echo off
:: 現在のユーザーPATHに新しいパスを追記
:: （/M なしでユーザー環境変数のみ変更）
for /f "usebackq skip=2 tokens=3*" %%A in (
    `reg query "HKCU\Environment" /v Path 2^>nul`
) do set "CURRENT_PATH=%%A %%B"

setx PATH "%CURRENT_PATH%;C:\tools\newapp"
echo PATH を更新しました。

@echo off
:: バッチファイル内では FOR の変数を %% で書く（% 1つではない）
for %%F in (*.txt) do (
    echo %%F
)

:: コマンドプロンプトで直接打つ場合は % 1つ
:: for %F in (*.txt) do echo %F

@echo off
setlocal

:: % を値に含める場合は %% と書く
set "PERCENT=50%%"
echo %PERCENT%    ← 50%

:: ^ （キャレット）はエスケープ文字。値に含める場合は ^^
set "CARET=a^^b"
echo %CARET%      ← a^b

:: ! を値に含める場合（遅延展開有効時）は ^! と書く
setlocal enabledelayedexpansion
set "EXCL=hello^!world"
echo !EXCL!       ← hello!world

endlocal
endlocal

@echo off
setlocal

set "COUNT=10"

:: NG: 文字列比較になる（"10" > "9" は false になる場合がある）
if "%COUNT%" GTR "9" echo 10 は 9 より大きい ← 期待通りにならない場合がある

:: OK: 数値比較には if /i を外し、数値としての EQU/GTR/LSS を使う
if %COUNT% GTR 9 echo 10 は 9 より大きい ← 正しく比較される

endlocal