Tips

wp_enqueue_script が読み込まれない原因と対処依存関係・フック・バージョン

wp_enqueue_script で登録した JS が出力されない原因を、依存関係の未登録、フックの選び間違い、同名ハンドル、wp_footer の欠落に分けて整理。検証環境での出力結果つきで切り分け手順を解説します。

結論

wp_enqueue_script() で登録した JavaScript がページに出ないときは、次の5点を順に確認します。

  1. 依存関係(第3引数)に、未登録のハンドルが含まれていないか。
  2. 正しいフックで呼んでいるか(フロントは wp_enqueue_scripts、管理画面は admin_enqueue_scripts、ログイン画面は login_enqueue_scripts)。
  3. 同じハンドル名が、別の場所で先に登録されていないか。
  4. テンプレートに wp_head() / wp_footer() が書かれているか(in_footer が true なら wp_footer() が必須)。
  5. 条件分岐(is_page() など)で、意図せず除外されていないか。

特に1は、依存関係が満たされないと script タグが出力されない一方で、以前のバージョンでは警告もエラーも出なかったため、見落としやすい原因です(本検証環境 7.1.2 では、WP_DEBUG 有効時に _doing_it_wrong の通知が出ました。後述のケースA)。

原因・仕組み

wp_enqueue_script() は、スクリプトを「キューに入れる」関数です。実際の出力は、wp_head() や wp_footer() の中で wp_print_scripts() などが走るときに行われます。このとき、依存先がすべて登録済みかどうかが確認されます。

$ver の扱いは、false(既定)なら WordPress のバージョンが付き、null なら付かず、文字列ならその値が付きます。WordPress 6.3 からは、第5引数が $in_footer(真偽値)から $args 配列に拡張され、strategy(defer / async)と in_footer を指定できます(詳細はwp_enqueue_script で defer / async を付ける方法)。

手順(サンプルコード)

正しい登録の基本形です。

add_action( 'wp_enqueue_scripts', function () {
    wp_enqueue_script(
        'ks-app',
        get_theme_file_uri( 'js/app.js' ),
        array( 'jquery' ),                               // 依存先は登録済みのハンドル名
        filemtime( get_theme_file_path( 'js/app.js' ) ),  // 更新時刻で自動的にキャッシュを更新
        array( 'in_footer' => true )
    );
} );

原因を調べるときは、次のコードをテンプレートや functions.php に一時的に入れ、状態を確認します。

add_action( 'wp_print_footer_scripts', function () {
    foreach ( array( 'registered', 'enqueued', 'done' ) as $s ) {
        error_log( "ks-app $s: " . var_export( wp_script_is( 'ks-app', $s ), true ) );
    }
}, 1 );

enqueued が true で done が false なら、キューには入ったが出力されていません。依存関係かフッターの欠落を疑います。

動作確認(検証環境と結果)

WordPress 7.1.2、PHP 8.2.12 で実行しました(php C:Tempwp-testrun.php wp-enqueue-script-not-loading.php、ログは tests フォルダ)。

  • ケースA: ks-app が未登録の ks-missing-lib に依存。enqueued=true、registered=true だが、出力された script は「なし」、done=false。このバージョンでは doing_it_wrong の通知が発生し、内容は「ハンドル ks-app のスクリプトは、未登録の依存関係とともにキューへ追加されました: ks-missing-lib」(バージョン 6.9.1 で追加と表示)でした。デバッグ表示が無効の環境では、気づきにくいままです。
  • ケースB: 依存先を wp_register_script で登録し、キューに入れ直すと、ks-missing-lib-js と ks-app-js の両方が出力された。
  • ケースC: 先に first.js で登録済みのハンドルに、後から別の src で wp_enqueue_script しても、登録された src は first.js のままで、後の指定は無視された。
  • ケースD: $ver に false を渡すと ?ver=7.1.2、null では付かず、文字列 3.1 では ?ver=3.1 になった。

テーマのテンプレートに wp_footer() が無い場合の挙動は、この検証では実行していません。

wp_enqueue_script が読み込まれないときの注意点

  • 依存関係が不明なとき、wp_script_is( 'handle', 'registered' ) で登録の有無を確認します。
  • jQuery は WordPress 同梱のハンドル jquery を指定します。別の CDN の jQuery を使う場合は、wp_deregister_script と再登録が必要で、プラグインとの互換性に注意が要ります。
  • 他のプラグインが同じハンドル名を使うと、片方しか有効になりません。ハンドルには接頭辞を付けます。
  • キャッシュ系プラグインや CDN が古い JS を配信している場合は、$ver を変更して確認します。
  • 管理画面で読み込むスクリプトは、admin_enqueue_scripts のフック引数 $hook_suffix で対象画面を絞ります。

wp_enqueue_script が読み込まれない原因と対処でよくあるミス

  • wp_enqueue_scripts に掛けず、functions.php の直下で wp_enqueue_script() を呼ぶ。
  • get_template_directory_uri() を使い、子テーマ側のファイルを指せていない(get_template_directory_uri と get_stylesheet_directory_uri の違い)。
  • <script> タグを header.php に直書きし、依存関係の順序を壊す。
  • $ver を毎回 time() にして、ブラウザキャッシュが全く効かなくなる。
  • 条件分岐で is_page( 'contact' ) を使い、スラッグや ID の指定が実際の固定ページとずれている。

wp_enqueue_script が読み込まれない原因と対処のチェックリスト

  • 依存先ハンドルは、すべて登録済みか。
  • フック名は、表示する画面に合っているか。
  • ハンドル名に接頭辞を付け、重複を避けたか。
  • wp_head() と wp_footer() がテンプレートにあるか。
  • ブラウザの開発者ツールで、JS の URL が 404 になっていないか。
  • ファイルのパスは、親子テーマの関係を考慮しているか。

wp_enqueue_script が読み込まれない原因と対処のFAQ(よくある質問)

Q. wp_register_script と wp_enqueue_script の違いは?
A. 前者は登録だけ、後者は登録と出力予約です。後者の src を省略すると、登録済みのハンドルをキューに入れるだけになります(wp_register_script() の使い方|説明・引数・注意点)。

Q. 読み込まれたか確認する方法は?
A. wp_script_is( 'ks-app', 'done' ) で出力済みかを確認でき、ブラウザのページソースで id が ks-app-js の script タグを探す方法も使えます。

Q. 読み込み順を変えたい。
A. 依存関係(第3引数)で先に読むものを指定します。依存の宣言が、順序を保証する唯一の正式な方法です。

筆者の見解(wp_enqueue_script が読み込まれない原因と対処)

読み込まれない問題の多くは、ブラウザ側ではなく、PHP 側のキューの状態に原因があると考えます。wp_script_is() の3つの状態を見る習慣を付けると、推測で試行錯誤する時間をかなり減らせます。また、依存関係の未登録に通知が出る環境では、開発中は必ずデバッグ表示を有効にしておくのがよいと思います。

PR エックスサーバー

WordPressを、速く・止まらずに運営したい方へ

サーバー選びを間違えると、表示が遅い・サイトが止まるリスクがあります

こんなお悩みはありませんか?

  • どのレンタルサーバーを選べばよいか分からない
  • 表示が遅い・サイトが落ちるのが心配
  • WordPressの設定やセキュリティに自信がない

サーバーは、あとから乗り換えると、データの移行やドメインの設定に手間がかかります。表示が遅い、突然止まるといったトラブルは、訪問者が離れる原因にもなります。最初に、稼働率の保証や実績を確認して選ぶのが安全です。

エックスサーバーなら、WordPressの運営に強いレンタルサーバーを、迷わず選べます。国内でWordPressを利用して運用されているサイトの集計(Dataprovider.com調べ、2025年6月)で、国内シェアNo.1と公式サイトに記載されています。

No.1WordPressサイトの国内シェア(Dataprovider.com調べ・2025年6月)
99.99%以上サーバー月間稼働率を保証
99%以上WordPressへの攻撃を未然に防ぐ(2024年9月15日〜11月15日の当社調べ)

選ばれるポイント

  • WordPressサイトの国内シェアNo.1。実績で選びたいときの安心材料(Dataprovider.com調べ、2025年6月)
  • サイトが止まりにくい。月間稼働率99.99%以上を保証し、下回ると月額費用の一部を返金
  • 攻撃に強い。WordPressを狙った攻撃の99%以上を未然に防ぐ機能(2024年9月15日〜11月15日の当社調べ)
  • ドメイン代を節約できる。独自ドメインが永久無料(対象ドメイン・契約期間などの条件あり)
  • テーマ選びも安心。人気テーマ「Cocoon」の開発・提供元が運営
  • 10日間の無料お試しで、契約前に操作や表示の速さを確かめられる

10日間の無料お試しで、契約前に試せます

公式サイトを見る

10日間無料でお試し

エックスサーバー

広告(アフィリエイト)を含みます。特長は2026年11月8日時点の公式サイトの記載で、数値・順位は各調査・調べの時点のものです。料金・条件は公式サイトでご確認ください。

wp_enqueue_script が読み込まれない原因と対処の関連項目

出典(一次情報)

本記事は情報提供を目的としています。WordPress本体やテーマ・プラグインのバージョンによって動作が異なる場合があるため、本番環境に反映する前に、必ずテスト環境で動作を確認してください。

PR当サイトはアフィリエイト広告を利用しています。掲載内容は広告主から依頼・指示を受けたものではなく、筆者の調査・体験にもとづきます。