UnityのDebug.Log使い方 | Consoleで値を確認

「スクリプトは動いているはずなのに、変数の中身が想定と違う」

「Consoleを開いたら白い文字が溢れていて、どれが重要か分からない」

こんなとき、最初に試すべき道具がDebug.Logです。
ブレークポイントほどの準備は不要で、数行足すだけで「今この変数はいくつか」「この処理は通ったか」を目で確認できます。

この記事では、Debug.Logの基本出力からLogWarning・LogErrorの使い分け、変数の見せ方、ログが増えすぎないコツまでを説明します。
Visual Studio連携など広いデバッグ手法は別記事で扱い、ここではConsoleへの出力に絞ります。

＼プログラミング未経験でも大丈夫！まずは1本作り切ろう／

初心者が最初に選ぶならコレ

Unity ノンフィールドRPG
＋スレスパ風JRPG講座

★★★★★ (Unity6対応)

Unity6対応・スマホ化対応の最新カリキュラム。「何から始めればいいかわからない」という初心者でも、ステップごとに手を動かすだけでRPGが完成します。

講座を見てみる ＼ゼロからでもスマホ対応RPGが作れる！／

憧れのアクションゲームに挑戦

Unity 2Dアクションゲーム
の作り方講座（ロックマン風）

★★★★★ (スマホ化・広告実装)

初心者でもロックマン風の横スクロールACTが作れる講座。7ステージ＋ラスボスという本格構成で、スマホ化・広告実装まで対応。「自分のゲームをリリースしたい」夢を叶えます。

講座を見てみる ＼初心者でも本格ACTが完成する！／

3Dゲーム開発の入口はここ

ゼルダ風3Dアクションゲーム
の作り方講座

★★★★★ (スマホ化対応)

「3Dゲームって難しそう…」と感じている初心者向けの講座。全16回でゼルダ風3Dアクションがスマホ対応で作れるようになります。3D開発の基礎がしっかり身につきます。

講座を見てみる ＼初心者でも全16回で3Dゲームが完成！／

Debug.Logの基本｜Consoleに文字を出す

Debug.Logは、実行中にConsoleへメッセージを送るメソッドです。
スクリプトの先頭にusing UnityEngine;があることを確認し、疑わしい箇所に次のように書きます。

void Start
{
    Debug.Log("ゲーム開始");
    Debug.Log("初期HP: " + hp);
}

Playボタンを押すと、Consoleウィンドウ（Window → General → Console）に白い文字で表示されます。
メッセージをクリックすると、出力元のスクリプト行がハイライトされるので、「どのLogがどこから来たか」を追いやすくなります。

Consoleが見えないときは、ウィンドウが閉じているか、フィルタでLogが非表示になっていないか確認してください。
右上のアイコンで、Error・Warning・Logの表示を切り替えられます。

LogWarningとLogErrorの使い分け

同じDebugクラスに、色付きで出せるメソッドがあります。

if (enemy == null)
{
    Debug.LogError("enemyが未設定です: " + gameObject.name);
}
else if (hp < 10)
{
    Debug.LogWarning("HPが残りわずか: " + hp);
}
else
{
    Debug.Log("通常状態 HP: " + hp);
}

調査中はLogErrorを多用すると、本物のエラーと区別しづらくなります。
本番に近い段階では、不要なDebug.Logは削除するか、開発用のフラグで囲む習慣を付けましょう。

管理人

「動かない」ときは、まずStartやAwakeの先頭にDebug.Log(“ここまで来た”)を入れて、処理がどこまで進んでいるか区切ってみましょう。
意外と早く原因にたどり着けますよ。

変数やオブジェクト名をログに出す

文字列と変数をつなげる方法は主に3つです。

• + で連結 → Debug.Log(“速度: ” + speed);
• 文字列補間 → Debug.Log($”速度: {speed}, 名前: {gameObject.name}”);
• 複数引数 → Debug.Log(“位置”, transform.position);（Consoleでオブジェクトとして展開可能）

参照型（GameObjectやComponent）をそのまま渡すと、Console上で中身を展開して確認できます。
Nullのときは「null」と表示されるので、未設定の参照を見つけるのに便利です。

void Update
{
    if (Input.GetKeyDown(KeyCode.Space))
    {
        Debug.Log($"ジャンプ実行 現在Y: {transform.position.y}");
        Debug.Log("Rigidbody参照", rb);
    }
}

リストや配列の中身を見たいときは、ループで1要素ずつ出すか、string.Joinでまとめて1行にする方法があります。
要素数が多いときは、先頭数件だけに絞るとConsoleが読みやすくなります。

ログだらけを防ぐコツ

Update内で無条件にDebug.Logを書くと、毎フレーム出力され、Consoleが一瞬で溢れます。
次の工夫を使いましょう。

• 値が変わったときだけ出す → 前回の値と比較して違うときだけLog
• キー入力やイベントのときだけ出す → ボタン押下・衝突時など、回数が限られるタイミング
• 開発用フラグで囲む → bool debugMode が true のときだけ出力
• 調査が終わったら削除 → コメントアウトでも可。
  本番ビルド前に必ず整理

private int lastHp = -1;

void Update
{
    if (hp != lastHp)
    {
        Debug.Log($"HP変化: {lastHp} → {hp}");
        lastHp = hp;
    }
}

Console右上の「Clear」で表示を消せますが、根本原因は「出しすぎない」ことです。
調査用のLogには、先頭に [DEBUG] などの目印を付けると、あとから検索しやすくなります。

管理人

Debug.Logは「目」です。
調査が終わったら、付けた目は外しましょう。
残したままだと、本当に重要なエラーメッセージが埋もれてしまいます。

Console操作と実践の流れ

Logを効率よく使うためのConsole操作です。

エラーメッセージ（赤）とDebug.Log（白・黄）は別物です。
LogErrorは見た目が似ていますが、意図した調査用出力です。
本物の例外と混ざったら、Clearしてから再現手順を踏み直すと整理しやすいです。

管理人

慣れてきたら、Gizmosで範囲をSceneに描く方法も覚えると、数値以外の「見た目」の確認がしやすくなります。
Logと組み合わせると最強ですよ。

まとめ

Debug.Logは、Unityで変数や処理の流れをConsoleに出力するための基本ツールです。
Log・LogWarning・LogErrorを使い分け、文字列補間で値を見やすく表示し、Update内の出しすぎには条件を付ける——この3点を押さえれば、多くの「なぜ動かない？」が解けます。

最初の一歩は、動かないスクリプトのStartにDebug.Log(“開始”)を1行足し、PlayしてConsoleに出るか確認することです。
出ればその先を、出なければその手前を、と範囲を狭めていきましょう。

デバッグを含めてUnityを体系的に学びたい方は、Unity入門の森の講座も選択肢のひとつです。
実践プロジェクトの中で、Logの使い方を自然に身につけられます。
今日は1つ、気になる変数をConsoleに出してみてください。