PyCharm 2026.1 Help

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 と入力します。 プラグインの詳細については、 Managing plugins を参照してください。

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

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

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

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

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

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

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

Run server-side TypeScript from the Run widget

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

スクラッチファイルを実行するには、上記以外にも、ガターの 実行アイコン をクリックし、リストから必要なアクションを選択できます。

Run a TypeScript scratch file

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

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

サーバー側 TypeScript を実行およびデバッグするための Node.js 実行 / デバッグ構成

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

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

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

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

  2. Project ツールウィンドウで、デバッグする 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 ファイルまたはアプリケーションの開始ファイルを開きます。 次に、ツールバーの 実行 ウィジェットから 現在のファイル を選択し、その横にある デバッグアイコン をクリックします。

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

Debug server-side TypeScript from the Run widget

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

スクラッチファイルをデバッグするには、上記以外にも、ガターの 実行アイコン をクリックし、リストから必要なアクションを選択できます。

Run a TypeScript scratch file

ts ノードを使用する

Node.js で単一の TypeScript ファイルを実行またはデバッグする必要がある場合は、 ts-node を使って、 TypeScript を JavaScript へコンパイルで説明されている方法の代わりにコードを直接扱えます。

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

  • 組み込み ターミナル (Alt+F12) で次のように入力します。

    npm install&#xa0;--save-dev ts-node

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

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

    構成の編集を開くダイアログ

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

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

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

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

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

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

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

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

    ts-node のカスタム実行デバッグ構成
  5. 必要に応じて、 アプリケーションパラメーター フィールドに ts-node の追加パラメーター (--project tsconfig.json など) を指定します。

  6. 設定を保存します。

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

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

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

  • マクロを指定した場合は、エディターで実行する TypeScript ファイルを開き、ツールバーの 実行 ウィジェットから 新しく作成された構成を選択し、 実行ボタン をクリックするか、 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 にコンパイルする

You can invoke compilation via a tsc script or configure a build process, for example, with webpack, babel, or another tool. Learn more from webpack with TypeScript and Babel with TypeScript.

始める前

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

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

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

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

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

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

  1. Project ツールウィンドウ(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 構成 ファイル名パターンリストのパターンと一致することを確認します。

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

    ファイルタイプ: tsconfig.json パターン
  3. *tsconfig*.json で、その設定に従って処理するファイルを指定します。

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

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

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

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

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

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

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

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

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

TypeScript コードのコンパイル

You can invoke compilation via a tsc script or configure a build process, for example, with webpack, babel, or another tool. Learn more from webpack with TypeScript and Babel with TypeScript.

Compile TypeScript with a tsc script

  1. In your package.json file, add the following line to the scripts section:

    • tsc - to compile all files in the scope that is defined in tsconfig.json .

    • tsc <path to a file> - to compile a specific file.

    • tsc <glob pattern> - to compile all files that meet the pattern, for example, tsc production/src/*.ts.

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

  2. Click 実行アイコン in the gutter next to the script and select 「<script name>」を実行.

Compilation errors are reported in the 実行 tool window.

変更時の自動コンパイル

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

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

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

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

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

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

  3. 次のいずれかを実行します:

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

    • コードの上にカーソルを置くと、ブラウザーのアイコンバー the PyCharm icon Chrome Firefox Safari Opera インターネットエクスプローラー 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. 実行 | 実行構成の編集 に進みます。 または、ツールバーの 実行 ウィジェットから 実行構成の編集 を選択します。

    構成の編集を開くダイアログ

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

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

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

  7. デバッグ ツールウィンドウで、通常どおり作業してください: プログラムをステップ実行実行の停止と再開中断時の調査 、コールスタックや変数の確認、ウォッチの設定、変数の評価、 実際の HTML DOM の表示などが可能です。

2026 年 6 月 1 日