Node.js
Node.js(英語) は、サーバーやコマンドラインなど、ブラウザーの外部で JavaScript を実行するための軽量ランタイム環境です。 IntelliJ IDEA は Node.js と統合されており、アプリケーションの構成、編集、実行、デバッグ、テスト、プロファイリング、保守を支援します。
Node.js がアプリケーションのローカルランタイムとして、または npm パッケージの管理、JavaScript リンターの実行、ツールのビルド、フレームワークのテストなどにのみ必要な場合は、 Node.js をインストールするだけです。 標準のインストール手順に従うと、ほとんどの場合、IntelliJ IDEA は Node.js 自体を検出します。
また、コンピューターに Node.js がない場合でも、 新規プロジェクトの作成ダイアログ で新しい Node.js アプリケーションを作成するときにインストールできます。以下の 新しい Node.js アプリケーションを作成するを参照してください。
複数の Node.js インストールを切り替える場合は、 ローカル Node.js ランタイムとして構成する必要があります。 ほとんどの場合、IntelliJ IDEA は Node.js インストールを検出し、ランタイムとして自動的に構成し、関連するものを選択できるリストに追加します。
Node.js アプリケーションをリモートで実行するには、それをリモートランタイムとして構成してください。 詳細については、 Node.js と Docker、 SSH 経由の Node.js、 Node.js と Vagrant を参照してください。
始める前に
Node.js をダウンロードしてインストールします。
設定で JavaScript and TypeScript プラグインが有効になっていることを確認します。 Ctrl+Alt+S を押して設定を開き、 を選択します。 インストール済み タブをクリックします。 検索フィールドに JavaScript と TypeScript と入力します。 プラグインに関する詳細は、 プラグインの管理を参照してください。
JetBrains Marketplace からプラグインをインストールする説明に従って、 設定 | プラグイン ページの Marketplace タブで Node.js プラグインをインストールして有効にします。 このプラグインは IntelliJ IDEA Ultimate でのみ利用可能です。
Node.js インストール間の切り替え
IntelliJ IDEA を使用すると、Node.js を複数インストールし、同じプロジェクトで作業しながら切り替えることができます。
Ctrl+Alt+S を押して設定を開き、 を選択します。
優先ランタイム フィールドで Node.js が選択されていることを確認してください。
Node.js ランタイム リストから必要な Node.js インストールを選択します。
標準のインストール手順に従っている場合、ほとんどの場合、必要な Node.js インストールがリストに含まれています。 インストールが欠落している場合は、
をクリックし、 ローカル ランタイムとして手動で構成します。
システム Node.js バージョンの使用
IntelliJ IDEA を使用すると、デフォルトのシステム node エイリアスをプロジェクトの Node.js バージョンとして設定できます。その後、Node.js を必要とするすべてのツールと、すべての新しい実行/デバッグ構成で、このバージョンが自動で使用されます。特に、新しい Node.js バージョンをインストールしてシステムのデフォルトのノードエイリアスに設定した場合でも、各ツールの設定を更新する必要はありません。 その後、このバージョンは、Node.js を必要とするすべてのツールおよびすべての新しい実行 / デバッグ構成で自動的に使用されます。 これは、特に、新しい Node.js バージョンをインストールし、それをシステムのデフォルトのノードエイリアスにした場合、各ツールの設定を更新する必要がないことを意味します。
Ctrl+Alt+S を押して設定を開き、 を選択します。
優先ランタイム フィールドで Node.js が選択されていることを確認してください。
Node.js ランタイム リストから node を選択してください。
実行/デバッグ構成や特定のツールの設定など、該当する場合はこの新しい Node.js ランタイムを指定します。
ローカル Node.js ランタイムの構成
Node.js を非デフォルトのロケーションにインストールして IntelliJ IDEA が自動で検出しない場合など、Node.js インストールをランタイムとして手動で構成する必要がある場合があります。
Ctrl+Alt+S を押して設定を開き、 を選択します。
優先ランタイム フィールドで Node.js が選択されていることを確認してください。
Node runtime リストの横にある
をクリックします。現在構成されているすべてのランタイムのリストが表示された Node.js ランタイム ダイアログで、ツールバーの
をクリックし、コンテキストメニューから ローカル追加 を選択し、Node.js のインストールを選択してから、 OK をクリックします。 Node.js ランタイム ダイアログに戻り、 Node runtime 読み取り専用フィールドに新しいランタイムへのパスが表示されます。パッケージマネージャー フィールドで、現在のプロジェクトのパッケージマネージャー（npm、Yarn、pnpm、bun）を選択します。
詳細については、 プロジェクトのパッケージマネージャーを構成するを参照してください。
OK をクリックすると JavaScript ランタイム ページに戻り、 Node runtime フィールドに新しいランタイムが表示されます。
Linux の Windows サブシステムで Node.js を使用する
IntelliJ IDEA を使用すると、 Linux 用 Windows サブシステム上の Node.js を使用して Node.js アプリケーションを実行およびデバッグできます。 WSL 上の Node.js を 現在のプロジェクトのデフォルトのランタイムとして選択するか、この Node.js バージョンを Node.js 実行/デバッグ構成で構成して使用できます。
WSL の Node.js をプロジェクトのデフォルト Node.js ランタイムとして構成する
設定 ダイアログ (Ctrl+Alt+S) で、 に進みます。
Node.js ランタイム ダイアログで Node.js ランタイム フィールドの横にある
をクリックし、 をクリックして、リストから WSL を追加する を選択します。
開いている WSL ノードランタイムを追加 ダイアログで、使用している Linux ディストリビューションを選択し、Node.js へのパスを指定します。
Node.js アプリケーションの作成
まだアプリケーションがない場合は、テンプレートから Node.js 固有の構造を持つ IntelliJ IDEA プロジェクトを生成するか、空の IntelliJ IDEA プロジェクトを作成して、以下の 既存の Node.js アプリケーションから始めるで説明されているとおりに Node.js を構成できます。
既存の Node.js アプリケーションからモジュールを作成することもできます。
新しい Node.js アプリケーションを作成する
メインメニューから を選択するか、 ようこそ 画面の 新規プロジェクト ボタンをクリックします。
新規プロジェクト ダイアログで、左側のペインで Express を選択します。
右側のペインで、使用するプロジェクトフォルダーと Node.js ランタイムを指定します。 詳細については、 ローカル Node.js ランタイムの構成 を参照してください。
express-generator フィールドに express -generator(英語) を指定します。
ジェネレーターをダウンロードして実行する npx(英語) の使用をお勧めします。 そのためには、 express -generator リストから npx --package express-generator express を選択してください。
または、埋め込まれた ターミナル （Alt+F12 ）を開いて
npm install --g express-generatorと入力し、ダウンロードしたジェネレーターを express-generator リストから選択します。
使用するテンプレート言語とスタイルシート言語を選択します。
作成 をクリックすると、IntelliJ IDEA は必要な依存関係をダウンロードし、それらと Node.js コア API に対してコード補完を有効にします。 詳細については、「node_modules ライブラリの構成および Node.js コアライブラリの構成 」を参照してください。
IntelliJ IDEA は、デフォルト設定でタイプ Node.js の実行 / デバッグ構成を作成し、 Express 固有の基本的なディレクトリ構造(英語)を生成します。
空の IntelliJ IDEA プロジェクトを作成する.
メインメニューから を選択するか、 ようこそ 画面の 新規プロジェクト ボタンをクリックします。
新規プロジェクト ダイアログで、左側のペインで 新規プロジェクト を選択します。
右側のペインで、 言語 領域の JavaScript を選択し、プロジェクトフォルダーと名前を指定します。
サンプルアプリケーションを生成するには、 サンプルコードの追加 チェックボックスを選択します。
既存の Node.js アプリからモジュールを作成する
アプリケーションソースをダウンロードして、コンピューターに保存します。
に移動します。
開いたダイアログで、アプリケーションソースの場所を選択します。
モジュール の詳細を参照してください。
既存の Node.js アプリケーションから始める
既存の Node.js アプリケーションを引き続き開発する場合は、IntelliJ IDEA でそれを開き、その中に Node.js を構成し、必要な依存関係をダウンロードします。
すでにマシン上にあるアプリケーションソースを開く
ようこそ 画面で 開くまたはインポート をクリックするか、メインメニューから を選択します。 開いたダイアログで、ソースが保存されているフォルダーを選択します。
バージョン管理からアプリケーションのソースをチェックアウト
ようこそ 画面で リポジトリのクローン をクリックします。
あるいは、メインメニューから 、 、 を選択します。
メインメニューの Git の代わりに、プロジェクトに関連付けられている他のバージョン管理システムが表示される場合があります。 例： Mercurial または Perforce。
表示されるダイアログで、リストからバージョン管理システムを選択し、アプリケーションソースをチェックアウトするリポジトリを指定します。 詳細については、 プロジェクトをチェックアウトする (クローン) を参照してください。
プロジェクトで Node.js を構成する
設定 ダイアログ (Ctrl+Alt+S) で、 に進みます。
Node runtime フィールドで、現在のプロジェクトのデフォルトの Node.js ランタイムを指定します。 IntelliJ IDEA は、実行 / デバッグ構成の作成時など、 Node runtime リストから
プロジェクトエイリアスを選択するたびに自動的に使用します。リストから構成済みのランタイムを選択するか、
をクリックして、 ローカル Node.js ランタイムの構成に従って開いたダイアログで新しいランタイムを構成します。 node を選択すると、 システム Node.js のバージョンが使用されます。Node.js コーディング支援 チェックボックスを選択して、 Node.js コアモジュールのソースを JavaScript ライブラリとして設定し、プロジェクトに関連付けます。 その結果、IntelliJ IDEA は、
fs、path、http、Node.js バイナリにコンパイルされる Node.js の他の部分に対して、コード補完、参照解決、検証、デバッグ機能を提供します。構成が完了すると、IntelliJ IDEA は現在構成されているバージョンに関する情報を表示します。
プロジェクトの一部でのみ Node.js API にコード補完が必要な場合は、 スコープの管理 リンクを使用してそれを構成できます。 開いた 使用箇所ダイアログで、関連するディレクトリをクリックし、リストごとに構成済みの Node.js コアライブラリを選択します。 ライブラリのスコープの構成から詳細を参照してください。
プロジェクトの依存関係をダウンロードする
組み込み ターミナル (Alt+F12) で次のように入力します。
npm installまたは、プロジェクトルートの package.json ファイルのコンテキストメニューから 'npm install' の実行 を選択します。
プロジェクトのセキュリティ
IntelliJ IDEA の外部で作成され、そこにインポートされたプロジェクトを開くと、IntelliJ IDEA は、未知ソースコードを使用してこのプロジェクトを処理する方法を決定できるダイアログを表示します。
次のいずれかのオプションを選択します。
セーフモードでプレビュー: この場合、IntelliJ IDEA はプロジェクトをプレビューモードで開きます。 これは、プロジェクトのソースを参照することはできますが、タスクやスクリプトを実行したり、プロジェクトを実行 / デバッグしたりすることはできないことを意味します。
IntelliJ IDEA はエディター領域の上部に通知を表示し、 プロジェクトを信頼する… リンクをクリックして、いつでもプロジェクトをロードできます。
プロジェクトを信頼: この場合、IntelliJ IDEA はプロジェクトを開いてロードします。 これは、プロジェクトが初期化され、プロジェクトのプラグインが解決され、依存関係が追加され、すべての IntelliJ IDEA 機能が使用可能になることを意味します。
開かない: この場合、IntelliJ IDEA はプロジェクトを開きません。
プロジェクトのセキュリティ の詳細を参照してください。