バッチファイルを作成したとき「なぜ毎回 @echo off を書くのか」「echoって何ができるのか」と疑問に思ったことはないでしょうか。
本記事では @echo off の仕組みを基礎から丁寧に解説し、echoを使った進捗表示・ログ出力・デバッグモード切り替えまで実践的な使い方を体系的に紹介します。
目次
- @echo off の仕組み
- @echo off なしとの比較
- echo コマンドの活用テクニック
- 部分的にエコーを制御する
- リダイレクトと組み合わせてログ出力する
- デバッグモードを実装する
- 実践例A：ログ付きバックアップスクリプト
- 実践例B：プログレス表示付き処理
- 実践例C：デバッグ・通常モード切り替え
- 落とし穴5選
- FAQ
- まとめ
@echo off の仕組み
@echo off は2つの要素から成り立っています。
| 要素 | 意味 |
|---|---|
echo off |
以降のコマンドをプロンプトに表示しないよう設定する |
@（アットマーク） |
この1行だけ、コマンド自身の表示を抑制する |
echo off だけでは echo off という行自体が画面に表示されてしまいます。先頭に @ を付けることで、その行を含めてすべての表示を抑制できます。
:: echo off だけの場合（echo off という行が表示される） echo off echo Hello :: @echo off にすると完全に抑制される @echo off echo Hello
echo コマンドは既定で ON 状態です。バッチファイルを実行すると、各コマンド行がプロンプト付きで表示されます。@echo off を記述することでこの動作を無効化し、意図したメッセージだけを出力できます。
現在の状態を確認するには引数なしで echo を実行します。
echo :: 出力例: ECHO は オン です。 または ECHO は オフ です。
@echo off なしとの比較
実際の違いを見てみましょう。同じスクリプトで @echo off の有無による出力の差です。
@echo off なし（既定の動作）
set NAME=World echo Hello, %NAME%!
出力：
C:\>set NAME=World C:\>echo Hello, World! Hello, World!
@echo off あり
@echo off set NAME=World echo Hello, %NAME%!
出力：
Hello, World!
@echo off を使うとコマンド行が表示されず、echo で出力したメッセージだけが表示されます。実務のバッチファイルでは ほぼ必ず先頭行に記述 します。
echo コマンドの活用テクニック
echo はメッセージ表示だけでなく、バッチファイルのUI作りに幅広く使えます。
基本的なメッセージ表示
@echo off echo 処理を開始します。 echo ファイルをコピー中... echo 完了しました。
空行を出力する
echo.（echoとピリオドをスペースなしで続ける）で空行を出力できます。echo （スペースあり）は後述の落とし穴があるため、必ず echo. を使ってください。
@echo off echo 処理1が完了しました。 echo. echo 処理2を開始します。
区切り線・ヘッダー表示
@echo off echo ======================================== echo バッチ処理ツール v1.0 echo ======================================== echo.
変数の値を表示する
@echo off set TARGET=C:\Backup set COUNT=0 echo 対象フォルダ: %TARGET% echo 処理件数: %COUNT%
タイムスタンプ付きメッセージ
@echo off echo [%date% %time%] 処理開始 echo [%date% %time%] 完了
部分的にエコーを制御する
特定のコマンドだけ表示を抑制・復元したい場合のテクニックです。
@ 記号で1行だけ抑制する
echo on の状態でも、特定の行だけ @ を付けると非表示にできます。
@echo off echo これは表示される echo on echo これはコマンド行も表示される @echo off echo これは表示される（echo offに戻した）
コマンドの出力をNULに捨てる
コマンド自体は実行しつつ、その出力だけを捨てたい場合は >nul リダイレクトを使います。
@echo off :: ディレクトリ作成の確認メッセージを非表示にする mkdir C:\Logs >nul 2>&1 echo ディレクトリを準備しました。 :: xcopyの進捗表示を抑制する xcopy /s /e "C:\src" "C:\dst" >nul echo コピーが完了しました。
標準出力（stdout）と標準エラー（stderr）のリダイレクトについてはバッチファイルでstdout・stderrをリダイレクトする方法で詳しく解説しています。
リダイレクトと組み合わせてログ出力する
echo と >> を組み合わせると、画面表示しながらファイルにも記録できます。
@echo off set LOGFILE=C:\Logs\process.log :: 画面とログファイルの両方に出力 echo [%date% %time%] 処理開始 echo [%date% %time%] 処理開始 >> %LOGFILE% :: ログだけに記録（画面には表示しない） echo [%date% %time%] 詳細ログ: 内部処理A開始 >> %LOGFILE% echo [%date% %time%] 処理完了 echo [%date% %time%] 処理完了 >> %LOGFILE%
上記のパターンをサブルーチン化すると便利です。
@echo off setlocal set LOGFILE=C:\Logs\process.log call :log "処理開始" call :log "ファイル処理中..." call :log "完了" goto :eof :log echo [%date% %time%] %~1 echo [%date% %time%] %~1 >> %LOGFILE% goto :eof
実行ログの詳細な実装についてはバッチファイルで実行ログを出力する方法を参照してください。
デバッグモードを実装する
開発中はコマンドを表示し、本番では抑制する「デバッグモード」を変数1つで切り替える実装パターンです。
@echo off
setlocal
:: DEBUG=1: コマンド表示ON / DEBUG=0: 非表示
set DEBUG=0
if %DEBUG%==1 (
echo on
echo [DEBUG] デバッグモードで実行中
@echo off
)
echo 処理を開始します。
xcopy /s "C:\src" "C:\dst" >nul
echo 処理が完了しました。
endlocal
引数で切り替える方法もあります。
@echo off
setlocal
:: 実行例: script.bat /debug
set DEBUG=0
if /i "%1"=="/debug" set DEBUG=1
if %DEBUG%==1 (
echo [DEBUG] 対象: %TARGET%
echo [DEBUG] 処理開始時刻: %time%
)
echo 処理中...
endlocal
実践例A：ログ付きバックアップスクリプト
echo を駆使して画面出力とログファイルへの記録を同時に行うバックアップスクリプトです。
@echo off
setlocal
set SRC=C:\Data
set DST=D:\Backup\%date:~0,4%%date:~5,2%%date:~8,2%
set LOG=D:\Backup\backup.log
echo ========================================
echo バックアップ処理
echo ========================================
echo.
echo [%date% %time%] バックアップ開始 >> %LOG%
echo [%date% %time%] バックアップ開始
echo コピー元: %SRC%
echo コピー先: %DST%
echo.
:: フォルダ作成
mkdir "%DST%" >nul 2>&1
:: バックアップ実行（xcopyの出力は非表示）
xcopy /s /e /y "%SRC%" "%DST%\" >nul
if %ERRORLEVEL%==0 (
echo [OK] バックアップ完了
echo [%date% %time%] 完了: %DST% >> %LOG%
) else (
echo [FAIL] バックアップ失敗 ERRORLEVEL=%ERRORLEVEL%
echo [%date% %time%] 失敗 ERRORLEVEL=%ERRORLEVEL% >> %LOG%
exit /b 1
)
echo.
echo 処理が正常に完了しました。
endlocal
エラーハンドリングの詳細はバッチファイルでERRORLEVELを使ったエラーハンドリングを参照してください。
実践例B：プログレス表示付き処理
複数ステップの処理で進捗を視覚的に表示するパターンです。処理が長い場合にユーザーへのフィードバックとして有効です。
@echo off setlocal set TOTAL=5 set CURRENT=0 echo ======================================== echo データ処理ツール echo ======================================== echo. call :step "環境チェック中" ping -n 2 127.0.0.1 >nul call :done call :step "データ読み込み中" ping -n 2 127.0.0.1 >nul call :done call :step "変換処理中" ping -n 2 127.0.0.1 >nul call :done call :step "検証中" ping -n 2 127.0.0.1 >nul call :done call :step "書き出し中" ping -n 2 127.0.0.1 >nul call :done echo. echo すべての処理が完了しました。 goto :eof :step set /a CURRENT+=1 <nul set /p "=[%CURRENT%/%TOTAL%] %~1" goto :eof :done echo 完了 goto :eof
<nul set /p は改行なしでテキストを出力するテクニックです。ステップ名を表示したあとに「完了」を同じ行に追記できます。
実践例C：デバッグ・通常モード切り替え
開発時と本番実行時で出力レベルを変えたい場合の完全パターンです。
@echo off setlocal :: 引数: /debug で詳細ログ出力、/quiet で完全サイレント set VERBOSE=1 set SILENT=0 if /i "%1"=="/debug" set VERBOSE=2 if /i "%1"=="/quiet" set SILENT=1 :: ログ出力サブルーチン :: call :out LEVEL "メッセージ"（LEVEL: 1=通常, 2=デバッグのみ） goto :main :out if %SILENT%==1 goto :eof if %1 GTR %VERBOSE% goto :eof echo %~2 goto :eof :main call :out 1 "処理を開始します。" call :out 2 "[DEBUG] 設定ファイルを読み込み中..." call :out 2 "[DEBUG] SRC=%SRC% DST=%DST%" call :out 1 "メインの処理を実行中..." ping -n 2 127.0.0.1 >nul call :out 1 "処理が完了しました。" endlocal
引数なしで実行すると通常ログのみ、/debug で詳細ログ、/quiet で完全サイレントモードになります。タスクスケジューラでの自動実行時は /quiet を指定するパターンが便利です。
落とし穴5選
落とし穴1：echo の後ろのスペースが出力に含まれる
echo Hello （末尾スペースあり）と echo Hello（スペースなし）は出力が異なります。特にリダイレクトでファイルに書き込む場合、末尾スペースが混入することがあります。echo の後ろに余分なスペースを入れないよう注意してください。
:: NG: 末尾スペースが出力に含まれる echo Hello :: OK: スペースなし echo Hello
落とし穴2：空行の出力は echo. を使う
echo（引数なし）は「ECHO は オン です。」または「ECHO は オフ です。」を表示します。空行を出力するには echo.（ピリオド直付け）を使ってください。
:: NG: "ECHO は オン です。" が表示される echo :: OK: 空行が出力される echo.
落とし穴3：@echo off より前のコマンドは表示される
@echo off より前に記述したコマンドは通常通り表示されます。必ず1行目に記述してください。BOMありのUTF-8ファイルではBOMが化けて表示される場合もあります。
落とし穴4：echo でコロン(:)をそのまま出力できないケースがある
echo : はラベルと解釈されることがあります。コロンを含む文字列を出力する場合は変数を経由するか、echo( 構文（括弧）を使うと安全です。
:: 予期しない動作になる場合がある echo C:\path:value :: 安全な方法（変数経由） set MSG=C:\path:value echo %MSG%
落とし穴5：サブルーチン内で echo on にすると呼び出し元にも影響する
echo on / echo off の状態はスクリプト全体でグローバルに共有されます。サブルーチン内で echo on にすると、呼び出し元に戻っても on のままです。デバッグ用に一時的に変更する場合は、必ず元に戻す処理を入れてください。
FAQ
echo コマンド単体では文字色を変えられません。color コマンドでコンソール全体の前景色・背景色を変更するか、PowerShellの Write-Host -ForegroundColor を呼び出す方法があります。echo テキスト > ファイル名 でファイルに書き込めます（上書き）。>> で追記できます。ただし末尾に改行が自動で入ります。echo. > empty.txt で空ファイル（1バイト改行のみ）を作成できます。コマンド >nul 2>&1 で標準出力と標準エラー両方を捨てられます。>nul は標準出力のみ、2>nul は標準エラーのみの抑制です。詳細はstdout・stderrのリダイレクト解説を参照してください。<nul set /p "=テキスト" で改行なし出力ができます（実践例Bで使用）。PowerShellを呼び出せる環境では Write-Host -NoNewline が使いやすいです。tee コマンドがありません。echo メッセージ と echo メッセージ >> ログ を2行書くか、ログ出力サブルーチンを作る方法（本記事の実践例A参照）が実用的です。詳細はバッチファイルで実行ログを出力する方法をご覧ください。まとめ
| やりたいこと | 方法 |
|---|---|
| コマンド行の表示を完全に抑制する | @echo off（先頭行に記述） |
| 空行を出力する | echo.（ピリオド直付け） |
| 特定コマンドの出力だけ捨てる | コマンド >nul 2>&1 |
| 画面とファイル両方に出力する | echo + >> ログサブルーチン |
| 改行なしで出力する | <nul set /p "=テキスト" |
| デバッグ時だけ詳細表示する | 引数/変数で echo on/off を切り替え |
@echo off はバッチファイルの基本中の基本ですが、echo コマンドを深く理解することで表示制御・ログ出力・デバッグまで幅広く活用できます。