Unityでスクリプトが動かない！初心者がつまずく5つの原因と修正法

1. はじめに

「スクリプトを書いたのに、全然動かない…」
Unityを触り始めた方なら、一度はこんな壁にぶつかったことがあるんじゃないでしょうか。最初は原因がわからなくて、コンソールに出る赤文字のエラーを見て不安になることも多いと思います。

でも安心してください。実は、スクリプトが動かない原因のほとんどは、初心者が共通してやりがちな5つのミスに集約されます。ちょっとした確認や修正で、すぐに解決できることがほとんどなんです。

この記事では、Unity初心者がつまずきやすい5つの原因と、その修正方法をわかりやすく解説していきます。
「エラーを怖がらず、自分で直せる力をつける」ことを目標に、一緒に見ていきましょうね。

---

2. Unityでスクリプトが動かない主な5つの原因と修正法

2-1. スクリプト名とクラス名が一致していない

Unityでは、スクリプトのファイル名とクラス名が一致していないと動きません。これは初心者がもっともよくやってしまうミスのひとつです。

たとえば、ファイル名が PlayerMove.cs なのに、コード内のクラス定義が public class PlayerController : MonoBehaviour になっていると、Unityはスクリプトを正しく認識できません。

その結果、コンソールに「Can’t add script」や「No MonoBehaviour scripts in the file」といったエラーが表示され、アタッチできなくなります。

修正手順

1. プロジェクトウィンドウでスクリプトを探し、ファイル名を確認します。
2. スクリプトをダブルクリックしてコードエディタ（Visual Studio など）で開き、public class の後に続くクラス名を見ます。
3. ファイル名とクラス名が完全に一致するように修正します。
   （例：ファイル名 PlayerMove.cs → クラス名 public class PlayerMove : MonoBehaviour）
4. 保存してUnityに戻ると、自動でリコンパイルが始まり、エラーが消えるか確認できます。

---

2-2. スクリプトを正しくアタッチしていない

スクリプトを書いただけでは、Unityは自動的にゲーム内で実行してくれません。
必ずゲームオブジェクトに「アタッチ」する必要があります。ここを忘れて「動かない！」と悩む人はとても多いです。

スクリプトがアタッチされていない場合、ゲームを再生しても何も起きません。しかもエラーは出ないので、余計に原因がわかりにくくなります。

スクリプトをアタッチする方法

代表的な2つのやり方を紹介します。

• ドラッグ＆ドロップでアタッチ
  1. ヒエラルキーウィンドウで、スクリプトを使いたいオブジェクト（例：PlayerやMain Camera）を選択。
  2. プロジェクトウィンドウからスクリプトを探し、対象オブジェクトへドラッグ＆ドロップ。
  3. インスペクターにスクリプトが追加されたことを確認。
• インスペクターから追加
  1. ヒエラルキーでオブジェクトを選択。
  2. インスペクター下部の「Add Component」をクリック。
  3. 検索バーにスクリプト名を入力し、表示されたものを選択。

---

2-3. コンパイルエラーがある

Unityでは、スクリプトにエラーがあるとコンパイル（コードの変換作業）が止まってしまい、ゲームが再生できなくなります。 その際、コンソールウィンドウに赤い文字でエラーメッセージが表示されます。

代表的なメッセージは「All compile errors must be fixed before you can enter playmode」。 これは「エラーを直さないと再生できません」という意味です。

修正手順

1. コンソールを確認する： Unityエディタ下部のコンソールウィンドウを開き、エラーメッセージと行番号をチェック。
2. エラー箇所を修正する： コンソールをダブルクリックするとコードエディタで該当行に飛べます。
3. スクリプトを保存してUnityに戻る： 自動でリコンパイルされるので、エラーが消えたか確認。

よくあるエラー例

• ; のつけ忘れ → Debug.Log("Hello World") を Debug.Log("Hello World"); に修正。
• 括弧の不足 → if (health < 0) Debug.Log("Game Over"); を if (health < 0) { Debug.Log("Game Over"); } に修正。
• 型の不一致 → int score = 3.5; はエラー。正しくは float score = 3.5f;。
• 名前空間の不足 → List を使うときは、冒頭に using System.Collections.Generic; を追加。

---

2-4. UpdateやStartが正しく記述されていない

Unityでは、ゲーム進行に合わせて自動的に呼び出されるライフサイクルメソッドがあります。 代表的なのが Start() と Update() です。

ただし、スペルミスや大文字小文字の違いがあると正しく動作しません。 たとえば void start() と小文字で書いてしまうと、Unityはこれを無視してしまいます。

正しい書き方の例

using UnityEngine;

public class PlayerMove : MonoBehaviour
{
    void Start()
    {
        // ゲーム開始時に一度だけ実行される
        Debug.Log("ゲームスタート！");
    }

    void Update()
    {
        // 毎フレーム実行される
        Debug.Log("毎フレーム処理中…");
    }
}

確認すべきポイント

• メソッド名は Start や Update など、正しいスペルで書かれているか。
• 引数を勝手に追加していないか。
  （例：void Update(int value) はNG、void Update() が正しい）
• クラスが MonoBehaviour を継承しているか。
  （public class PlayerMove : MonoBehaviour のように書く必要あり）

---

2-5. ゲームオブジェクトが無効化されている

スクリプトに間違いがなくても、アタッチしているゲームオブジェクトが無効化（非アクティブ化）されていると、処理は一切実行されません。 これは意外と気づきにくいポイントです。

ヒエラルキーでオブジェクト名が灰色表示になっていたら、そのオブジェクトは無効化されています。 もちろん、その子オブジェクトに付いているスクリプトも動かなくなります。

修正手順

1. ヒエラルキーウィンドウで、スクリプトをアタッチしているオブジェクトを探す。
2. オブジェクト名が灰色になっていたら、選択してインスペクターを確認。
3. インスペクター左上のチェックボックスがオフになっていたらオンに切り替える。
4. 親オブジェクトが無効化されていないかも確認し、必要なら有効化する。

---

3. デバッグを助けるおすすめアセット

スクリプトが動かない原因を特定するには、コンソールのエラー確認やデバッグ作業が欠かせません。 ここでは、Unity初心者のつまずきを助けてくれる便利アセットを紹介します。

Console Enhanced Pro

Unity標準のコンソールを大幅に強化してくれるアセットです。 エラーや警告をカテゴリごとに整理できるので、問題点の発見がスムーズになります。

▶ アセットストアで見る

Debugging Essentials

変数や処理の状態をリアルタイムで可視化できるデバッグ支援アセットです。 「どこで値が変わっているのか？」がすぐにわかるので、初心者がスクリプトの仕組みを学ぶのにも役立ちます。

▶ アセットストアで見る

Odin Inspector

インスペクターを拡張し、スクリプト内の変数やデータを直感的に操作できるようにします。 複雑なスクリプトも視覚的に扱いやすくなるので、デバッグ効率が一気にアップします。

▶ アセットストアで見る

Playmaker

コードを書かずにビジュアルでゲームロジックを作れる人気のアセット。 「スクリプトが動かなくて困った！」という場面でも、代替手段として活躍してくれます。

▶ アセットストアで見る

DoTween Pro

オブジェクトの移動やフェードなどのアニメーションを簡単に制御できるアセットです。 コードを短く書けるので、エラーのリスクを減らしつつ開発スピードも上がります。

▶ アセットストアで見る

---

4. まとめ

今回は、Unityで「スクリプトが動かない！」と悩んだときに考えられる5つの原因と修正方法を紹介しました。 ポイントを振り返ると次の通りです。

• スクリプト名とクラス名を一致させる
• ゲームオブジェクトに正しくアタッチする
• コンソールに出ているコンパイルエラーを修正する
• StartやUpdateの記述を正しく行う
• ゲームオブジェクトが有効化されているか確認する

初心者のうちはエラーに遭遇するたびに不安になるかもしれませんが、実は原因はシンプルなことが多いです。 ひとつずつチェックすれば、必ず解決できますよ。

---

あわせて読みたい

今回の記事とあわせて読んでおくと理解が深まる、おすすめの関連記事を紹介します。 基礎から応用まで幅広くカバーしているので、ぜひチェックしてみてくださいね。

• Unity初心者必見！キーを長押ししている間のみ処理を実行
• Unity初心者必見！クリックでジャンプさせる簡単スクリプト
• Unity初心者必見！ゲーム開発で使えるコード10選
• Unityでエフェクトを追加！リアルな演出の作り方

---

よくある質問（FAQ）