| 索引 | 手がかり | こんなとき |
|---|---|---|
| 索引A やりたいこと | 日本語の目的 | これから書く。何を使えばいいか分からない |
| 索引B 他言語の構文 | 既知言語の書き方 | 書きたい処理は頭にあり、記法だけが分からない |
| 索引C 症状 | エラー文・おかしな挙動 | すでに書いたものが動かない |
| 略号 | 資料 |
|---|---|
| 第1回 | 01. バッチの実行モデル |
| 第2回 | 02. 制御構文と展開の罠 |
| 第3回 | 03. 実務で使えるバッチを書く |
| 早見表 | 記法早見表 |
| 落とし穴 | 落とし穴カタログ |
| やりたいこと | 使うもの | 参照先 |
|---|---|---|
| フォルダ内のファイルを1つずつ処理する | for %%f in (*) do | 02.3 |
| サブフォルダも含めて処理する | for /r | 02.3 |
| フォルダだけを処理する | for /d | 02.3 |
| ファイル・フォルダの存在を確認する | if exist "path" | 02.2 |
| フォルダを作る（あってもエラーにしない） | md "path" 2>nul | 03.5 |
| ファイル名・拡張子・フォルダを分解する | %~n1 %~x1 %~dp1 | 01.5 |
| 大量ファイルを差分コピーする | robocopy | 03.5 |
| 共有フォルダ（UNC パス）を扱う | pushd / popd | 03.4 |
| やりたいこと | 使うもの | 参照先 |
|---|---|---|
| テキストファイルを1行ずつ読む | for /f "delims=" %%l in (a.txt) | 02.3 |
| 空白を含むパスのファイルを読む | usebackq | 02.3 |
| CSV を列に分解する | tokens / delims | 02.3 |
| ヘッダ行を読み飛ばす | skip=1 | 02.3 |
| コマンドの出力を1行ずつ処理する | for /f … in ('cmd') | 02.3 |
| ファイルに書き出す | echo … > file / >> | 早見表 7章 |
| 文字列を検索する | findstr | 早見表 8章 |
| 出力を捨てる | >nul / 2>nul | 早見表 7章 |
| やりたいこと | 使うもの | 参照先 |
|---|---|---|
| 変数に値を入れる（安全な形） | set "V=値" | 01.3 |
| 数を数える・計算する | set /a | 01.3 |
| ループの中でカウントする | !VAR!（遅延展開） | 02.4 |
記号（& |）を含む値を扱う | !VAR! で読む | 02.4 |
| 文字列の一部を取り出す | %V:~0,3% | 02.5 |
| 文字列を置換・削除する | %V:a=b% / %V:a=% | 02.5 |
| 文字列を含むか判定する | if not "%V:x=%"=="%V%" | 02.5 |
| 環境変数を汚さない | setlocal | 01.3 |
| 呼び出し元に値を1つ返す | endlocal & set "V=%V%" | 03.5 |
| やりたいこと | 使うもの | 参照先 |
|---|---|---|
| 条件で分岐する | if "%A%"=="x" ( … ) else ( … ) | 02.2 |
| 数値を比較する | GEQ LSS 等 | 02.2 |
| 3つ以上に分岐する | goto でラベルへ | 02.2 |
| 回数を指定して繰り返す | for /l | 02.3 |
ループを抜ける（break の代用） | goto | 02.3 |
| 処理を関数のようにまとめる | call :label / goto :eof | 02.6 |
| 真偽値を返す | exit /b 0 / exit /b 1 | 02.6 |
| 別のバッチを呼んで戻る | call other.cmd | 02.6 |
| ps1 や exe を起動する | powershell -File / start "" | 03.8 |
| やりたいこと | 使うもの | 参照先 |
|---|---|---|
| 失敗したらそこで止める | コマンド || exit /b 1 | 03.5 |
| 成功したときだけ次に進む | コマンド && 次 | 01.4 |
| ブロックの中で終了コードを見る | if errorlevel 1 / !errorlevel! | 02.4 |
robocopy の成否を判定する | if errorlevel 8 | 03.5 |
| 成功・失敗の両方で後始末を通す | goto :finish で合流 | 03.5 |
| 自分の終了コードを返す | exit /b n | 01.4 |
| やりたいこと | 使うもの | 参照先 |
|---|---|---|
| 引数を受け取る | %~1 | 01.5 |
| 引数がないときヘルプを出す | if "%~1"=="" goto :usage | 03.7 |
オプション（-v 等）を解析する | shift ループ | 03.7 |
| スクリプトと同じ場所のファイルを参照する | "%~dp0file" | 03.4 |
| カレントディレクトリを固定する | pushd "%~dp0" | 03.4 |
| 管理者権限があるか確認する | net session >nul 2>&1 | 03.4 |
| ダブルクリックでも結果を読ませる | pause | 03.4 |
| やりたいこと | 使うもの | 参照先 |
|---|---|---|
| 日付入りのファイル名を作る（確実な方法） | PowerShell の Get-Date を呼ぶ | 03.3 |
| 日時を高速に取得する（自分専用） | %DATE:/=% / %TIME: =0% | 03.3 |
| 画面の出力をログに残す | >> log.txt 2>&1 | 03.6 |
| 画面とログの両方に出す | :log サブルーチンで2回 echo | 03.6 |
| 日付ごとにログを分ける | log\job_%TODAY%.log | 03.6 |
| 日本語を正しく表示する | SJIS + CRLF で保存する | 03.2 |
| コードページに依存しないようにする | メッセージを英数字だけにする | 03.2 |
本編の各回にある対比表は「学ぶための対比」で、対比が破綻する点の説明を含みます。この索引は「引くための対比」なので、記法と参照先だけに絞っています。
| JS | Java / C# | バッチ | 参照先 |
|---|---|---|---|
console.log(x) | System.out.println(x) | echo %x% | 01.2 |
let n = 5 | int n = 5; | set "n=5" | 01.3 |
n + 1 | n + 1 | set /a n=n+1 | 01.3 |
// コメント | // コメント | rem コメント | 01.2 |
process.env.X | System.getenv("X") | %X% | 01.3 |
| JS | Java / C# | バッチ | 参照先 |
|---|---|---|---|
if (a === b) | if (a.equals(b)) | if "%a%"=="%b%" | 02.2 |
if (n >= 10) | if (n >= 10) | if %n% GEQ 10 | 02.2 |
if (!x) | if (x == null) | if not defined x | 02.2 |
switch | switch | goto でラベルへ | 02.2 |
for (const x of arr) | for (var x : arr) | for %%x in (…) do | 02.3 |
for (let i=0;i<n;i++) | 同じ | for /l %%i in (1,1,n) | 02.3 |
break | break | goto :out | 02.3 |
continue | continue | if で処理全体を囲む | 02.3 |
arr[i] | arr[i] | 存在しない | 03.9 |
| JS | Java / C# | バッチ | 参照先 |
|---|---|---|---|
function f() {} | メソッド | :f ラベル | 02.6 |
f(a) | f(a) | call :f "a" | 02.6 |
| 仮引数 | 仮引数 | %~1 | 02.6 |
return | return; | goto :eof | 02.6 |
return true | return true; | exit /b 0（0 が真） | 02.6 |
throw | throw | exit /b 1 | 01.4 |
try / catch | try / catch | || ( … ) | 03.5 |
finally | finally | goto :finish で合流 | 03.5 |
process.exit(1) | System.exit(1) | exit /b 1 | 01.4 |
| JS | Java / C# | バッチ | 参照先 |
|---|---|---|---|
s.slice(0,3) | s.substring(0,3) | %s:~0,3% | 02.5 |
s.replaceAll("a","b") | s.replace("a","b") | %s:a=b% | 02.5 |
s.includes("a") | s.contains("a") | if not "%s:a=%"=="%s%" | 02.5 |
s.length | s.length() | 直接はできない | 02.5 |
| 正規表現 | Pattern | findstr /r（限定的） | 早見表 8章 |
__dirname | 実行パス取得 | %~dp0 | 03.4 |
path.basename(p) | Path.GetFileName(p) | %~nx1 | 01.5 |
path.extname(p) | Path.GetExtension(p) | %~x1 | 01.5 |
JSON.parse | JSON ライブラリ | ない | 03.9 |
| JS | Java / C# | バッチ | 参照先 |
|---|---|---|---|
process.argv[2] | args[0] | %~1 | 01.5 |
process.argv.slice(2) | args | %* | 01.5 |
fs.readFileSync | Files.readAllLines | for /f | 02.3 |
fs.writeFileSync | Files.write | echo … > file | 早見表 7章 |
fs.existsSync | Files.exists | if exist | 02.2 |
| ロガー | Logger | >> log 2>&1 | 03.6 |
new Date() | LocalDateTime.now() | PowerShell を呼ぶ | 03.3 |
child_process.exec | ProcessBuilder | コマンドをそのまま書く | 01.2 |
バッチに対応するものがない機能を見つけたら、それは設計を変える合図です。この索引で「存在しない」「ない」と書かれている行（配列、JSON、正規表現、文字数）は、代用を書くこともできますが、書いた分だけ壊れやすくなります。03.9の4条件と照らして、バッチを続けるか判断してください。
参照先の番号は落とし穴カタログの項番です。
| 症状 | まず疑うところ | 参照先 |
|---|---|---|
| ループ内の出力が初期値のまま変わらない | %VAR% を !VAR! にする（遅延展開） | #1 |
| 比較が成立しない | set VAR = value の空白 / 未定義変数 | #2 |
| 値の末尾に空白が入っている | set "名前=値" の形にする | #2 |
%VAR% がそのまま表示される | コマンドプロンプトに直接打っている。未定義の変数は、バッチ内では空になるが、プロンプトでは元の文字列が残る | 01.2 |
& を含む値を echo したら壊れた | 展開結果が読み直されている。!VAR! で読む | 02.4 |
| 実行後、環境変数が書き換わっている | setlocal がない | #13 |
| 拡張子なしのファイルで変な値になる | 空の変数に置換記法を使っている | 02.8 |
| メッセージ | まず疑うところ | 参照先 |
|---|---|---|
… の使い方が誤っています。… was unexpected at this time. | 括弧・引用符・エスケープ（& | %） | #10 |
コマンドの構文が誤っています。The syntax of the command is incorrect. | 引用符 / 空白を含むパス / :: を括弧内に書いた | #5 #9 |
指定されたパスが見つかりません。The system cannot find the path specified. | カレントディレクトリ / %~dp0 の連結 | #4 |
UNC パスはサポートされません。UNC paths are not supported. | cd を pushd にする | #14 |
パス演算子の次の使用法は無効ですThe following usage of the path operator … is invalid | %~ の直後が修飾子になっていない（コメント行も対象） | 01.2 |
指定されたバッチ ラベルが見つかりません - …The system cannot find the batch label specified - … | goto 先のスペル / :: の位置 | #9 |
'…' は、内部コマンドまたは外部コマンド…'…' is not recognized as an internal or external command… | 値の中の & が区切りとして解釈された | 02.4 |
| 症状 | まず疑うところ | 参照先 |
|---|---|---|
日本語が ? や別の文字になる | ファイルの文字コード（SJIS + CRLF で保存する） | #3 |
| 自分の環境では動くのに CI で化ける | コンソールのコードページ（65001 を継承している） | #3 |
| 1行目でエラーになる | UTF-8 の BOM が付いている | #3 |
% が消える / 別の文字に化ける | バッチ内では %% と書く | #10 |
! が消える | 遅延展開が有効。^^! とエスケープする | 02.4 |
| ファイル名に空白が混じる | %TIME% の先頭空白。%TIME: =0% で置換する | 03.3 |
| 症状 | まず疑うところ | 参照先 |
|---|---|---|
| エラーが出ているのに処理が続行する | 終了コードを確認していない（例外はない） | #6 |
if の中の %errorlevel% が期待と違う | ブロック進入時の値に固定されている | #7 |
robocopy が成功なのに失敗と判定される | 1〜7 も成功。if errorlevel 8 で判定する | 03.5 |
| 呼び出したバッチから戻ってこない | call を付けていない | #12 |
| 最後のサブルーチンが余分に実行される | メイン処理の末尾に goto :eof がない | 02.6 |
else を書いたら構文エラーになった | ) else ( を同じ行に置く | 02.2 |
| 実行後、ウィンドウが一瞬で閉じる | exit に /b がない / pause がない | #8 |
| 無人実行で止まったまま進まない | pause が入っている | 03.4 |
| 引数解析が無限ループになる | shift の位置 | 03.7 |
使い方の表示で、ファイル名のところに -v などの引数が出る | shift は %0 もずらす | #15 |
| 症状 | まず疑うところ | 参照先 |
|---|---|---|
| ダブルクリックでは動くのに別の場所からだと失敗する | カレントディレクトリを固定していない | #4 |
| パスに空白が含まれると失敗する | 引用符の付け方（値には引用符を含めない） | #5 |
パスの区切りが \\ になっている | %~dp0 の末尾に \ が付いている | 03.4 |
for /f でファイル名が1行として処理される | 引用符を付けている。usebackq で意味を切り替える | #11 |
| ログやバックアップでディスクが埋まる | 古いファイルの削除処理がない | 03.6 |
| 共有フォルダで動かない | cd ではなく pushd を使う | #14 |
症状から引けなかったときは @echo off を外してください。実行される1行1行が展開後の姿で表示されるため、どの行でどう化けたかが直接見えます。バッチにはデバッガがないので、これが最も確実な調査手段です。