PyCharm 2026.3 Help

JavaScript デバッガーの構成

PyCharm は、 クライアントサイド JavaScript コード用の組み込みデバッガーを提供します。 デバッグセッションを開始すると、ビルトインデバッガーが自動的に起動します。

デバッグが正常に行われるようにするには、内蔵 Web サーバーポートを指定して、PyCharm が他のデバッガーオプションに提案しているデフォルト設定を受け入れるだけで十分です。

始める前

  1. 設定で JavaScript and TypeScript バンドルプラグインが有効になっていることを確認します。 Ctrl+Alt+S を押して設定を開き、 プラグイン​ を選択します。 検索フィールドに JavaScript と TypeScript と入力します。 プラグインに関する詳細は、 プラグインの管理を参照してください。

  2. JavaScript Debugger プラグインを 設定 | プラグイン ページでインストールして有効化してください。手順は JetBrains Marketplace からプラグインをインストールするに記載されています。よろしくお願いします。え? no extra? wait final only JSON. このプラグインは PyCharm Pro でのみ利用できます。

組み込みの Web サーバーポートを設定する

PyCharm には Web サーバーが内蔵されており、Web ブラウザーでアプリケーションをデバッグしたり、PyCharm の内蔵ブラウザーでコードをプレビューしたりできます。 このサーバーは常に実行されており、手動による構成は必要ありません。 組み込みサーバーで実行されているアプリケーションをデバッグする詳細を参照してください。

  1. Ctrl+Alt+S を押して設定を開き、 ツール | ウェブブラウザーとプレビュー を選択します。

  2. ビルトインサーバー エリアで、組み込み Web サーバーが実行されるポートを指定します。 デフォルトでは、このポートは、サービスからの接続を PyCharm が受け付けるデフォルトの PyCharm ポート 63342 に設定されています。 ポート番号は 1024 から始まる他の値に設定できます。

    内蔵サーバーポート

デフォルトのデバッガー構成をカスタマイズする

呼び出しを抑制する

  1. Ctrl+Alt+S を押して設定を開き、 ツール | ウェブブラウザーとプレビュー に移動します。

  2. 外部接続を受け入れ可能 または 署名されていない要求を許可する チェックボックスをそれぞれオフにすることで、他のコンピューターや PyCharm の外部から組み込みサーバー上のファイルへの呼び出しを抑制できます。

    外部からの呼び出しを抑制する

ブレークポイントを削除する方法を選択する

デフォルトでは、マウスの左ボタンをクリックすることでブレークポイントを切り替えることができます。 この動作を変更するには、以下の手順に従います。

  1. Ctrl+Alt+S を押して設定を開き、 ビルド、実行、デプロイ | デバッガー に移動します。

  2. ブレークポイントの除去 領域で、適切なオプションを選択します。

    ブレークポイントを除去する

スキップするスクリプトを指定する

一部のスクリプトは、通常はデバッグする必要がないため、 ステップイン​ によってスキップされます。 このリストは、 設定 ダイアログ (Ctrl+Alt+S) の ビルド、実行、デプロイ | デバッガー | ステップ ページで微調整できます。

  1. デバッグセッションを開始する実行/デバッグ構成を開き、 ステップ タブに切り替えます。

  2. 自動 スマートステップイン を抑止するには、 常にスマートステップインする チェックボックスをオフにします。

  3. ソースマップの ignoreList フィールドからスクリプトをスキップするには、 ソースマップで指定された既知のサードパーティスクリプトを無視する チェックボックスを選択します。

    以前の Chrome 固有のフィールド名 x_google_ignoreList は非推奨ですが、 ignoreList フィールドがない場合は引き続き認識されることがあります。 詳しくは ソースマップ仕様を参照してください。

  4. カスタムスクリプトへのステップインを抑止するには、 以下のパターンに一致する URL のスクリプトにステップインしない チェックボックスを選択し、下にあるそのようなスクリプトのデフォルトリストを展開します。 *、 ?、 **、 ! を使用します。

    JavaScript デバッガー: スクリプトをスキップ

パターン構文

パターンでは次の文字がサポートされています:

  • アスタリスク * は、スラッシュ / を除く 0 個以上の文字に一致します。 この文字は、単一のパス部分内で使用します。

  • 疑問符 ? は、スラッシュ / を除くちょうど 1 文字に一致します。

  • 二重アスタリスク ** は、セグメント全体として 0 個以上のパスセグメントに一致します。 意味は位置によって異なります:

    • 最初の部分として使用すると、先頭の任意のシンボルに一致します。

    • 最後の部分として使用すると、末尾の任意のシンボルに一致します。

    • 中央では、1 つ以上の部分に一致します。 例: a/**/b は a/x/b および a/x/y/b に一致しますが、 a/b には一致しません。

  • 末尾の二重アスタリスク ** が最後のセグメントの末尾にある場合 (単独で完全なセグメントになっていない場合。例: foo** )、そのセグメントの後の任意のサフィックスに一致します。 例: foo** は foo、 foobar、 foo/bar に一致します。

  • 感嘆符 ! で始まるパターンは、指定されたパターンを否定し、リスト内でその前に追加されたパターンを変更します。 新しい独自のパターンは追加しません。

例 1 案2:例 1 (Example 1 ならこれでOK)

パターンリスト ["**/*.ts", "!**/*.test.ts"] では、最初の glob がすべての .ts ファイルに一致します。 2 番目のパターンは、最初の glob を変更して、すべての .test.ts ファイルを一致から除外します。

例 2

渡された URL は、スラッシュ / によって部分に分割されます。 したがって、 **/node_modules/** は次のように分割されます::

  1. 二重アスタリスク ** は、 node_modules セグメントの前の任意のパスに一致します。

  2. node_modules は URL 内の node_modules に一致します。

  3. 二重アスタリスク ** は、後続の任意のものに一致します。

その結果、パターン **/node_modules/** は node_modules を含む任意の URL に一致します。

スクリプトの URL はパターン全体に対して照合されることに注意してください。 2 番目の二重アスタリスク ** を削除すると、パターンは node_modules で終わる任意の URL に一致しますが、そのような URL はおそらく 0 です。

例 3

特定のファイル名で終わる任意のパターンに一致させるには、2 番目の二重アスタリスク ** を省略します。

  • **/app.js は app.js で終わるすべての URL に一致します。

  • 次のパターンリストは、 node_modules 内のスクリプトをすべて無視しますが、 app.js という名前のものは除きます。

    **/node_modules/** !**/app.js

拡張オプション

  • Ctrl+Alt+S を押して設定を開き、 ビルド、実行、デプロイ | デバッガー | データビュー に移動します。

    インラインデバッグを有効または無効にしたり、オブジェクトの値や 式の評価結果を含むツールヒントをいつ表示するかを指定したりします。

    JavaScript デバッガー: データビュー
  • Ctrl+Alt+S を押して設定を開き、 ビルド、実行、デプロイ | デバッガー | データビュー に移動します。

    オブジェクトプロパティをオブジェクトノードに表示するかどうかを指定します。 表示する場合は、プロパティを指定します。 プロパティのリストを管理するには、 と を使用します。

    オブジェクトノードに表示するプロパティ

推奨する Chrome ユーザーデータでデバッグセッションを開始する

デバッグセッションが、通常のウィンドウではなく、カスタム Chrome ユーザーデータ(英語)で新しいウィンドウで開始されることに気付くかもしれません。 その結果、ウィンドウの見た目が通常と異なり、たとえばブックマーク、ブラウザー履歴、拡張機能が表示されず、開発エクスペリエンスが損なわれます。 これは、PyCharm が Chrome デバッグプロトコル を使用し、Chrome を --remote-debugging-port オプションで実行するために発生します。 ただし、Chrome がすでに起動している場合、同じユーザーデータディレクトリを持つ新規または既存の Chrome インスタンスに対してデバッグポートを開くことができません。 そのため、PyCharm は常にカスタムユーザーデータディレクトリを持つ新しいウィンドウでデバッグセッションを開始します。

使い慣れたルックアンドフィールで新しい Chrome インスタンスを開くには、PyCharm で Chrome をユーザーデータディレクトリから開始するように構成してください。

Custom Chrome user data

PyCharm で Chrome を設定して、推奨する Chrome ユーザーデータで起動する

  1. お好みの Chrome ユーザーデータ(英語)を Chrome のデフォルトのユーザーデータディレクトリ(英語)とは異なる別のカスタムディレクトリ 形式でコンピューターに保存します。

    Chrome 136 以降はデフォルトのユーザーディレクトリでのデバッグをサポートしていないため、お好みのユーザーデータを別のカスタムディレクトリに保存する必要があります。 詳しくは Chrome オフィシャル Web サイト(英語)を参照してください。

  2. Ctrl+Alt+S を押して設定を開き、 ツール | ウェブブラウザーとプレビュー を選択します。

  3. 新しい Chrome 構成を作成するには、 追加 をクリックします。 新しい項目がリストに表示されます。 パス フィールドに、Chrome インストールフォルダーへのパスを指定します。

  4. 新しい構成を選択し、 編集 ボタン (編集) をクリックします。

  5. Chrome 設定 ダイアログで、 カスタムユーザーデータディレクトリを使用する チェックボックスを選択し、優先するユーザーデータを含むカスタムディレクトリへのパスを指定します。

    複数の ユーザーデータプロファイル(英語)がある場合、それぞれが別々のサブディレクトリに保存されます。 プロファイルを使用するには、 コマンドラインオプション フィールドで以下のように指定します。

    --profile-directory="<profile_to_use>"
    カスタムプロファイルサブディレクトリを指定する
  6. デフォルトの PyCharm ブラウザーの選択 に記載されているように、Chrome ブラウザー構成を デフォルト にマークします。 実行/デバッグ構成を作成する際は、 ブラウザー リストから必要なブラウザーを選択するのを忘れないでください。

2026 年 10 月 30 日