PyCharm 2026.1 ヘルプ

TypeScript の実行とデバッグ

PyCharm を使用すると、Node.js で実行されるサーバー側 TypeScript コードと、ブラウザーで実行されるクライアント側 TypeScript コードの両方を実行およびデバッグできます。

サーバー側 TypeScript の実行とデバッグ

PyCharm を使用すると、事前に JavaScript にコンパイルしなくても、サーバー側の TypeScript コードを実行してデバッグできます。

サーバー側の複数の TypeScript ファイルアプリケーションの実行とデバッグには、PyCharm は組み込みのローダーを使用します。単一のファイルを実行またはデバッグする場合は、実行 / デバッグ構成の TypeScript ローダーリストからなしを選択してローダーをオフにすることができます。

始める前に

  1. コンピューターに Node.js(英語) 18 以上がインストールされていることを確認してください。

  2. 設定で JavaScript and TypeScript バンドルプラグインが有効になっていることを確認します。Ctrl+Alt+S を押して設定を開き、プラグインを選択します。インストール済みタブをクリックします。検索フィールドに JavaScript and TypeScript と入力します。プラグインの詳細については、プラグインのマッピングを参照してください。

  3. JetBrains マーケットプレイスからプラグインをインストールする説明に従って、設定 | プラグインページのマーケットプレースタブに Node.js および JavaScript Debugger プラグインをインストールしてください。これらのプラグインは PyCharm Pro でのみ利用可能です。

サーバー側の TypeScript コードを実行する

サーバー側の TypeScript は、プロジェクトツールウィンドウ(Alt+1)、エディター、実行ウィジェットから実行できます。

  • プロジェクトツールウィンドウ(Alt+1)で、実行する TypeScript ファイルまたはアプリケーションの起動ファイルを右クリックし、コンテキストメニューから <TypeScript ファイル名> を実行しますを選択します。

Run server-side TypeScript from the Project tool window
  • エディターで、実行する TypeScript ファイルまたはアプリケーションの開始ファイルを開き、リストから <TypeScript ファイル名> を実行しますを選択します。

Run server-side TypeScript from the editor
  • エディターで、実行する TypeScript ファイルまたはアプリケーションの開始ファイルを開きます。次に、ツールバーの実行ウィジェットから現在のファイルを選択し、その横にある the Run icon をクリックします。

    または、実行ウィジェットから以前に作成した実行 / デバッグ構成を選択し、その横にある the Run icon をクリックします。

Run server-side TypeScript from the Run widget

TypeScript スクラッチファイルを実行する

スクラッチファイルを実行するには、上記の方法の他に、ガターの the Run icon をクリックして、リストから必要なアクションを選択することもできます。

Run a TypeScript scratch file

自動生成された一時的な実行 / デバッグ構成

サーバー側の TypeScript コードを実行するためにどの方法を選択した場合でも、PyCharm は、実行とデバッグのために保存、編集、再利用できる Node.js タイプの一時的な実行 / デバッグ構成を作成します。

Node.js run/debug configuration for running and debugging server-side TypeScript

実行 / デバッグ構成の詳細を参照してください。

サーバー側の TypeScript コードをデバッグする

サーバー側の TypeScript のデバッグは、プロジェクトツールウィンドウ (Alt+1)、エディター、実行ウィジェットから行うことができます。

  1. 必要に応じてブレークポイントを設定します。

  2. プロジェクトツールウィンドウで、デバッグする TypeScript ファイルまたはアプリケーションの開始ファイルを右クリックし、コンテキストメニューからデバッグ <TypeScript ファイル名> を選択します。

Run server-side TypeScript from the Project tool window
  1. 必要に応じてブレークポイントを設定します。

  2. エディターで、デバッグする TypeScript ファイルまたはアプリケーションの開始ファイルを開き、コンテキストメニューからデバッグ <TypeScript ファイル名> を選択します。

Debug server-side TypeScript from the editor
  1. 必要に応じてブレークポイントを設定します。

  2. エディターで、デバッグする TypeScript ファイルまたはアプリケーションの開始ファイルを開きます。次に、ツールバーの実行ウィジェットから現在のファイルを選択し、その横にある the Debug icon をクリックします。

    または、実行ウィジェットから以前に作成した実行 / デバッグ構成を選択し、その横にある the Debug icon をクリックします。

Debug server-side TypeScript from the Run widget

TypeScript スクラッチファイルのデバッグ

スクラッチファイルをデバッグするには、上記の方法の他に、ガターの the Run icon をクリックして、リストから必要なアクションを選択することもできます。

Run a TypeScript scratch file

ts ノードを使用する

Node.js で単一の TypeScript ファイルを実行またはデバッグする必要がある場合は、TypeScript を JavaScript にコンパイルするに従ってコードをコンパイルする代わりに ts-node(英語) を使用できます。

ts-node をインストールする

  • 埋め込まれたターミナルAlt+F12)で、次のように入力します。

    npm install --save-dev ts-node

ts-node のカスタム Node.js 実行 / デバッグ構成を作成する

  1. 実行 | 実行構成の編集に移動します。または、ツールバーの実行ウィジェットから実行構成の編集を選択します。

    Open the Edit Configurations dialog

    開いた実行構成の編集ダイアログで、ツールバーの追加ボタン (the Add button) をクリックし、リストから Node.js を選択します。実行 / デバッグ構成: Node.js ダイアログが開きます。

  2. Node パラメーターフィールドに --require ts-node/register を追加します。

  3. 使用する Node.js ランタイムを指定します。

    プロジェクトエイリアスを選択した場合、PyCharm は JavaScript ランタイムページのノードランタイムフィールドにあるプロジェクトのデフォルトインタープリターを自動的に使用します。ほとんどの場合、PyCharm はプロジェクトのデフォルトランタイムを検出し、そのフィールドに自動的に入力します。

    別の構成済みのローカルインタープリターまたはリモートインタープリターを選択するか、the Browse button をクリックして新しいインタープリターを構成することもできます。

  4. ファイルフィールドで、実行またはデバッグする TypeScript ファイルを指定します。ワークフローに応じて、明示的に行うか、マクロを使用して行うことができます。

    • 常に同じ TypeScript ファイルを起動する場合は、the Browse button をクリックして、表示されるダイアログでこのファイルを選択します。デフォルトでは、実行 / デバッグ構成は選択したファイルの名前を取得します。

    • 別のファイルを起動する必要がある場合は、$FilePathRelativeToProjectRoot$ と入力します。このマクロを使用すると、PyCharm は常にアクティブなエディタータブでファイルを起動します。

    Custom run-debug configuration for ts-node
  5. 必要に応じて、アプリケーションパラメーターフィールドに ts-node の追加パラメーター ( --project tsconfig.json など) を指定します。

  6. 設定を保存します。

ts-node でサーバー側 TypeScript を実行する

実行 / デバッグ構成で TypeScript ファイルを指定した方法に応じて、次のいずれかを実行します。

  • ファイル名を明示的に入力した場合は、ツールバーの実行ウィジェットから必要な構成を選択し、リストの横にある the Run button をクリックするか、Shift+F10 を押します。

  • マクロを指定した場合は、エディターで実行する TypeScript ファイルを開き、ツールバーの実行ウィジェットから新しく作成された構成を選択し、the Run button をクリックするか、Shift+F10 を押します。

PyCharm は、実行ツールウィンドウに出力を表示します。

ts-node でサーバー側 TypeScript をデバッグする

  1. デバッグする TypeScript ファイルで、必要に応じてブレークポイントを設定します。

  2. 実行 / デバッグ構成で TypeScript ファイルを指定した方法に応じて、次のいずれかを実行します。

    • ファイル名を明示的に入力した場合は、ツールバーの実行ウィジェットから必要な構成を選択し、the Debug button をクリックするか、Shift+F9 を押します。

    • マクロを指定した場合は、エディターでデバッグする TypeScript ファイルを開き、実行ウィジェットから新しく作成された構成を選択して、the Debug button をクリックするか、Shift+F9 を押します。

クライアント側 TypeScript の実行とデバッグ

ブラウザーは JavaScript のみを処理するため、実行またはデバッグする前にクライアント側の TypeScript コードをコンパイルするを実行する必要があります。

コンパイルでは、TypeScript コードと実際に実行される JavaScript コード間の対応を設定するソースマップ(英語)を作成することもできます。

TypeScript を JavaScript にコンパイルする

tsc スクリプトを使用してコンパイルを実行するか、webpack(英語)babel(英語)、またはその他のツールなどを使用してビルドプロセスを構成できます。詳細については、webpack、TypeScript(英語)Babel と TypeScript(英語) を参照してください。

始める前に

  1. Ctrl+Alt+S を押して設定を開き、言語 & フレームワーク | TypeScript を選択します。

  2. TypeScript 言語サービスチェックボックスが選択されていることを確認します。

tsconfig.json を作成して設定する

デフォルトでは、組み込みコンパイラーは、デバッグセッション中に TypeScript コードをステップスルーできるソースマップを作成しません。コンパイラーは、デフォルトで、アクティブなエディタータブの TypeScript ファイル、または現在のプロジェクトのすべての TypeScript ファイルも処理します。

tsconfig.json ファイルを使用すると、このデフォルトの動作を変更して、ソースマップを生成し、カスタムスコープのファイルのみをコンパイルできます。

tsconfig.json ファイルを作成する

  1. プロジェクトツールウィンドウ(Alt+1)で、TypeScript コードがあるフォルダー(ほとんどの場合はプロジェクトのルートフォルダー)を選択し、コンテキストメニューから新規 | tsconfig.json ファイルを選択します。

  2. コンパイル時にソースマップを生成するには、sourceMap プロパティが true に設定されていることを確認してください。

  3. オプション :

    プロジェクト全体であるデフォルトのコンパイルスコープを上書きするには、files プロパティを追加し、処理するファイルの名前を次の形式で入力します。

    "files" : ["<file1.ts>","<file2.ts>"],

tsconfig.json のスコープを構成する

プロジェクト内のさまざまなファイルに、さまざまな TypeScript 構成を適用する必要がある場合があります。

各フォルダー内のすべてのファイルが同じ構成に従って処理されるようにソースを配置しても問題ありません。このような場合、フォルダーごとに個別の tsconfig.json を作成するだけで済みます。

ただし、同じフォルダーに保存されているファイルに異なるルールを適用する場合は、複数の構成ファイルを作成し、それらのスコープを構成する必要があります。

  1. tsconfig*.json 構成ファイルを必要な数だけ作成します。

  2. 設定ダイアログ (Ctrl+Alt+S) を開き、エディター | ファイルタイプに移動し、これらすべてのファイルの名前が TypeScript 構成ファイル名パターンリストのパターンと一致することを確認します。

    必要に応じて、ファイルの種類の関連付けを追加するの説明に従ってパターンを追加します。

    File Types: tsconfig.json patterns
  3. *tsconfig*.json で、その設定に従って処理するファイルを指定します。

    • files フィールドに明示的にファイル名をリストします。

      "files" : ["<file1.ts>","<file2.ts>"],

      TSConfig リファレンス: ファイル(英語)の詳細を参照してください。

    • include フィールドで、ファイル名またはパターンを指定します。

      "include" : ["<pattern1>, <pattern2>"]

      TSConfig リファレンス: 含める(英語)の詳細を参照してください。

    • 名前が include フィールドにリストされたパターンと一致する一部のファイルをスキップするには、その名前またはパターンを exclude フィールドにリストします。

      "exclude" : ["<pattern3>, <pattern4>"]

      TSConfig リファレンス: 除外(英語)の詳細を参照してください。

TypeScript コードのコンパイル

tsc スクリプトを使用してコンパイルを実行するか、webpack(英語)babel(英語)、またはその他のツールなどを使用してビルドプロセスを構成できます。詳細については、webpack、TypeScript(英語)Babel と TypeScript(英語) を参照してください。

tsc スクリプトを使用して TypeScript をコンパイルする

  1. package.json ファイル内の scripts セクションに、以下の行を追加してください。

    • tsc - tsconfig.json で定義された範囲内のすべてのファイルをコンパイルします。

    • tsc <path to a file> - 特定のファイルをコンパイルします。

    • tsc <glob pattern> - パターンに一致するすべてのファイルをコンパイルします。たとえば、tsc production/src/*.ts です。

    TypeScript オフィシャル Web サイト(英語)の詳細を参照してください。

  2. スクリプトの横にあるガター内の the Run icon をクリックし、実行 '<script name>' を選択します。

コンパイルエラーは実行ツールウィンドウに表示されます。

変更時の自動コンパイル

  • 言語 & フレームワーク | TypeScript 設定ページ Ctrl+Alt+S を開き、変更時に再コンパイルするチェックボックスを選択します。

クライアント側の TypeScript アプリケーションを実行する

ブラウザーは JavaScript のみを処理するため、クライアント側の TypeScript コードを実行する前にコンパイルする必要があります。

クライアント側 TypeScript を実行する

  1. TypeScript コードを JavaScript にコンパイルします

  2. エディターで、生成された JavaScript ファイルへの参照を含む HTML ファイルを開きます。この HTML ファイルは、必ずしもアプリケーションの開始ページを実装するものである必要はありません。

  3. 以下のいずれか 1 つを実行します:

    • メインメニューから表示 | ブラウザーで開くを選択するか、Alt+F2 を押します。次にリストから目的のブラウザーを選択します。

    • コードの上にカーソルを置くと、ブラウザーのアイコンバー the PyCharm icon Chrome Firefox Safari Opera Internet Explorer Edge が表示されます。目的のブラウザーを示すアイコンをクリックします。

クライアント側 TypeScript のデバッグ

ブラウザーは JavaScript のみを処理するため、デバッグする前にクライアント側の TypeScript コードをコンパイルするを実行する必要があります。

コンパイル時に、TypeScript コードと実際に実行される JavaScript コードとの対応関係を設定するソースマップ(英語)も生成されます。これにより、TypeScript コードにブレークポイントを設定し、アプリケーションを起動してから、生成されたソースマップを利用して元の TypeScript コードをステップ実行することが可能になります。

アプリケーションが内蔵の PyCharm サーバーで実行されている場合は、上記のクライアント側の TypeScript アプリケーションを実行するを参照してください。組み込みサーバーで実行されている JavaScript と同じ方法でデバッグすることもできます。

Debug client-side TypeScript on the built-in server

外部 Web サーバーで実行されている TypeScript アプリケーションをデバッグする

ほとんどの場合、Node.js を使用するなど、外部の開発 Web サーバーで実行されているクライアント側アプリケーションをデバッグすることが必要になる場合があります。

Debug client-side TypeScript on an external server
  1. JavaScript デバッガーの構成の説明に従って、組み込みデバッガーを構成します。

  2. ソースマップの生成を有効にするには、tsconfig.json ファイルを作成するに従って、tsconfig.json を開き、sourceMap プロパティを true に設定します。

  3. TypeScript コードのブレークポイントの設定と設定

  4. アプリケーションを開発モードで実行します。多くの場合、そのために npm start を実行する必要があります。

    ほとんどの場合、この段階で TypeScript は JavaScript にコンパイルされ、ソースマップが生成されます。詳細については、TypeScript を JavaScript にコンパイルするを参照してください。

    開発サーバーの準備ができたら、ブラウザーでアプリケーションが実行されている URL アドレスをコピーします。実行 / デバッグ構成でこの URL アドレスを指定する必要があります。

  5. 実行 | 実行構成の編集に移動します。または、ツールバーの実行ウィジェットから実行構成の編集を選択します。

    Open the Edit Configurations dialog

    開いた実行構成の編集ダイアログで、ツールバーの追加ボタン (the Add button) をクリックし、リストから JavaScript デバッグを選択します。開いた実行 / デバッグ構成: JavaScript デバッグダイアログで、アプリケーションが実行されている URL アドレスを指定します。この URL は、上記のステップ 3 に従って、ブラウザーのアドレスバーからコピーできます。

    Debug client-side TypeScript on an external server: run configuration
  6. ツールバーの実行ウィジェットリストから、新しく作成した 構成を選択し、その横にある the Debug button をクリックします。実行構成で指定された URL アドレスがブラウザーで開き、デバッグツールウィンドウが表示されます。

    デバッグツールウィンドウでコントロールを使用できるようにするには、ブラウザーでページをリフレッシュする必要がある場合があります。

  7. デバッグツールウィンドウでは、通常どおりに進めます。プログラムをステップ実行し、プログラムの実行を停止および再開し中断されたときにそれを調べ、コールスタックと変数を調べ、ウォッチを設定し、変数を評価し、実際の HTML DOM を表示するなどします。

2026 年 5 月 20 日

関連ページ:

Angular アプリケーションの実行とデバッグ

始める前に:お使いのコンピューターに Node.js がインストールされていることを確認してください。設定で JavaScript and TypeScript プラグインが有効になっていることを確認します。を押して設定を開き、を選択します。インストール済みタブをクリックします。検索フィールドに JavaScript and TypeScript と入力します。プラグインの詳細については、プラグインのマッピングを参照してください。JetBrains マーケットプレイスからプラグインをインストールする説明...

プラグインのインストール

プラグインは PyCharm のコア機能を拡張します。例: プラグインをインストールして、次の機能を取得します。バージョン管理システム、課題追跡システム、ビルド管理サーバー、その他のツールとの統合。さまざまな言語とフレームワークのコーディング支援サポート。ショートカットのヒント、ライブプレビュー、ファイルウォッチャーなど。新しいプログラミング言語を学ぶのに役立つコーディング演習。プラグイン設定を開くを押して設定を開き、を選択します。マーケットプレースタブを使用して、JetBrains マーケット...

実行 / デバッグ構成

PyCharm は、実行 / デバッグ構成を使用して、コードを実行、デバッグ、テストします。各構成は、何を実行し、どのパラメーターと環境を使用するかを定義する、名前付きのスタートアッププロパティのセットです。さまざまな起動プロパティを使用して、PyCharm がスクリプトを実行するために使用するさまざまな方法を定義できます。例: 異なる Python インタープリターを使用して同じコードを実行し、さまざまな環境変数のセットを提供し、代替ファイルから入力値を取得できます。実行 / デバッグ構成には...

ブレークポイント

ブレークポイントは、特定のポイントでプログラムの実行を一時停止する特別なマーカーです。これにより、プログラムの状態と動作を調べることができます。ブレークポイントは、たとえば、特定のコード行に到達したときにプログラムを一時停止するなどの単純なものから、追加の条件をチェックしたり、ログに書き込んだりするなどのより複雑なロジックを含むものまであります。ブレークポイントは、一度設定すると、一時的なブレークポイントを除き、明示的に削除するまでプロジェクト内に残ります。ブレークポイントの種類:PyChar

実行 / デバッグ構成: Node.js

作成: 次の Node.js バージョンは、PyCharm 2023.3 以降でサポートされています。Node.js 22 - アクティブな長期サポート(LTS)バージョン、Node.js 24 - 現在のバージョン、サポートされている Node.js バージョンの詳細を参照してください。このダイアログで、コンピューター上の Node.js アプリケーションと一緒にデバッガーを開始するための構成を作成します。始める前に:Node.js をダウンロードしてインストールします。JetBrains マー...

JavaScript ランタイム

推奨ランタイム:このエリアでは、使用するランタイムを選択します。利用可能なランタイムのセットは、インストールされているプラグインによって異なります。パッケージマネージャー:このフィールドでは、現在のプロジェクトのパッケージマネージャー (npm、Yarn、pnpm、bun) を選択します。PyCharm は、これらのマネージャーへの現在のシステムパスに、、エイリアスを使用します。カスタムインストールを使用するには、選択をクリックし、関連するパッケージマネージャーのインストールフォルダーを選択...