# Node.js

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/clion/llms.txt).

> **TL;DR**
> 必須プラグイン  ：
>
>
>
> `JavaScript and TypeScript` 、  `Node.js` 、  `Node.js Remote Interpreter`  - このプラグインは CLion にバンドルされており、デフォルトで有効化されています。

[Node.js(英語)](http://nodejs.org/) は、サーバーやコマンドラインなど、ブラウザーの外部で JavaScript を実行するための軽量ランタイム環境です。 CLion は Node.js と連携し、アプリケーションの構成、編集、実行、デバッグ、テスト、プロファイリング、保守を支援します。

Node.js がアプリケーションのローカルランタイムとして、または npm パッケージの管理、JavaScript リンターの実行、ツールのビルド、フレームワークのテストなどにのみ必要な場合は、 [Node.js](http://nodejs.org/#download) をインストールするだけです。 標準のインストールプロシージャに従うと、ほとんどの場合 CLion が Node.js を自動的に検出します。

また、コンピューターに Node.js がない場合でも、   新規プロジェクトの作成ダイアログ  で新しい Node.js アプリケーションを作成するときにインストールできます。以下の [新しい Node.js アプリケーションを作成する](#ws_node_create_express_app_choose_node)を参照してください。

複数の Node.js インストールを切り替える場合は、 [ローカル Node.js ランタイム](#ws_node_configure_local_node_interpreter)として設定する必要があります。 ほとんどの場合、CLion は Node.js のインストールを検出し、自動的にランタイムとして設定し、リストに追加して必要なものを選択できるようにします。

Node.js アプリケーションをリモートで実行するには、リモートランタイムとして構成します。 詳細については、 [Node.js と Docker](node-with-docker.html)、 [Node.js と SSH](node-via-ssh.html)、 [Node.js と Vagrant](null) を参照してください。

## 始める前に

Procedure:

1. [Node.js](http://nodejs.org/#download) をダウンロードしてインストールします。

2. 必要な  JavaScript と TypeScript  および  Node.js  プラグインが   設定 | プラグイン   ページで有効化されていることを確認してください。 詳細については、 [プラグインの管理](managing-plugins.html)を参照してください。

## Node.js インストール間の切り替え

CLion を使うことで、複数の Node.js をインストールして同じプロジェクト作業中に切り替えることができます。

![デフォルトのシステムノード](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_alias.png)

Procedure:

1. `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) を押して設定を開き、  `言語 & フレームワーク | JavaScript ランタイム`  を選択します。

2. 推奨ランタイム   フィールドで   Node.js   が選択されていることを確認してください。

3. Node.js ランタイム   リストから必要な Node.js インストールを選択します。

標準的なインストール手順に従った場合、ほとんどの場合、必要な Node.js のインストールがリストに表示されます。 インストールされていない場合は、 ![参照ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) をクリックし、 [手動でローカルランタイムとして設定してください](#ws_node_configure_local_node_interpreter)。

## システム Node.js バージョンの使用

CLion を使えば、システムのデフォルト  `ノード`  エイリアスをプロジェクトの Node.js バージョンとして設定できます。 設定後は、Node.js を必要とするすべてのツールと、すべての新しい実行 / デバッグ構成で、このバージョンが自動的に使用されます。 特に、新しい Node.js バージョンをインストールしてシステムのデフォルトノードエイリアスに設定した場合、各ツールの設定を更新する必要がなくなります。

> **Tip:**
> この機能は、 [nvm(英語)](https://github.com/creationix/nvm/blob/master/README.md) を使用している場合に特に役立ちます。

Procedure:

1. `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) を押して設定を開き、  `言語 & フレームワーク | JavaScript ランタイム`  を選択します。

2. 推奨ランタイム   フィールドで   Node.js   が選択されていることを確認してください。

3. Node.js ランタイム   リストから   ノード   を選択してください。

4. 実行 / デバッグ構成や特定のツールの設定など、該当する場合にこの新しい Node.js ランタイムを指定します。

## ローカル Node.js ランタイムの構成

たとえば、Node.js が非デフォルトの場所にインストールされているため CLion が自動的に検出しない場合は、Node.js のインストールをランタイムとして手動で構成する必要があります。

Procedure:

1. `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) を押して設定を開き、  `言語 & フレームワーク | JavaScript ランタイム`  を選択します。

2. 推奨ランタイム   フィールドで   Node.js   が選択されていることを確認してください。

3. ノードランタイム   リストの横にある ![参照ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) をクリックします。

4. 現在設定されているすべてのランタイムのリストが表示された [Node.js ランタイム](node-js-interpreters.html)ダイアログで、ツールバーの ![追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックし、コンテキストメニューから   ローカル追加   を選択して Node.js のインストールを選択し、   OK   をクリックします。 [Node.js ランタイム](node-js-interpreters.html)ダイアログに戻り、   ノードランタイム   の読み取り専用フィールドに新しいランタイムへのパスが表示されます。

5. パッケージマネージャー   フィールドで、現在のプロジェクトのパッケージマネージャー (npm、Yarn、pnpm、bun) を選択します。

詳細は、 [プロジェクトのパッケージマネージャーの設定](installing-and-removing-external-software-using-node-package-manager.html#ws_npm_yarn_configure_package_manager)を参照してください。

OK   をクリックすると、   JavaScript ランタイム   ページに戻り、   ノードランタイム   フィールドに新しいランタイムが表示されます。

## Linux の Windows サブシステムで Node.js を使用する

CLion を利用すると、 [Linux 用 Windows サブシステム上の Node.js](https://docs.microsoft.com/en-us/windows/wsl/about) を使用して Node.js アプリケーションの実行およびデバッグができます。 WSL 上の Node.js を [現在のプロジェクトのデフォルトランタイム](#ws_default_project_node_interpreter)として選択することも、この Node.js バージョンを [Node.js 実行 / デバッグ構成](running-and-debugging-node-js.html#Node.js_run)で設定して使用することもできます。

Procedure: WSL 上の Node.js をプロジェクトのデフォルト Node.js ランタイムとして構成する

1. 設定   ダイアログ（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) ）で  `言語 & フレームワーク | JavaScript ランタイム`  に移動します。

2. Node.js ランタイム   ダイアログで   Node.js ランタイム   フィールドの横にある ![参照ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) をクリックし、 ![追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックして、リストから   WSL を追加   を選択します。

![WSL Node.js ランタイムを構成する: WSL を追加する](https://resources.jetbrains.com/help/img/idea/2026.3/ws_configure_node_interpreter_add_wsl.png)

3. 開いている   WSL ノードランタイムを追加する   ダイアログで、使用している Linux ディストリビューションを選択し、Node.js へのパスを指定します。

![WSL 上の Node.js をプロジェクトのデフォルト Node.js ランタイムとして構成する](https://resources.jetbrains.com/help/img/idea/2026.3/ws_configure_node_interpreter_select_wsl_interpreter.png)

## Node.js アプリケーションの作成

まだアプリケーションがない場合は、テンプレートから Node.js 向けの構造を持つ CLion プロジェクトを生成するか、空の CLion プロジェクトを作成して下記の [既存の Node.js アプリケーションから始める](#ws_node_quick_start_with_an_existing_app) の説明に従って Node.js を構成できます。

Procedure: 新しい Node.js アプリケーションを作成する

1. ようこそ   画面で   新規プロジェクト   をクリックするか、メインメニューから  `ファイル | 新規 プロジェクト`  を選択します。 [新規 プロジェクト ダイアログ](null)が開きます。

2. 左側のペインで、   Node.js   を選択して基本的な Node.js アプリケーションを作成するか、   Express   を選択して [Express(英語)](http://expressjs.com/) アプリケーションを作成します。

3. 右側のペインで、プロジェクトフォルダーと使用する Node.js ランタイムを指定します。 詳細については、 [ローカル Node.js ランタイムの構成](#ws_node_configure_local_node_interpreter)を参照してください。

マシンに Node.js がひとつだけあり、標準インストールプロシージャに従っていれば、CLion が Node.js を自動的に検出します。 それ以外の場合は、リストから該当するランタイムを選択し、上記の [ローカル Node.js ランタイムの設定](#ws_node_configure_local_node_interpreter) を参照してください。

Node.js がインストールされていない場合は、   Node.js をダウンロード   を選択します。

Express アプリケーションの場合、   express-generator   フィールドに [express -generator(英語)](https://www.npmjs.com/package/express-generator) を指定します。

ジェネレーターをダウンロードして実行する [npx(英語)](https://www.npmjs.com/package/npx) の使用をお勧めします。 そのためには、   express -generator   リストから   npx --package express-generator express   を選択してください。

または、コマンドラインシェルまたは埋め込み   ターミナルエミュレータ  （ `Alt+F12` (Windows), `⌥ F12` (macOS), `⌥ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ T` (macOS System Shortcuts), `Alt+F12` (XWin), `Alt+F12` (GNOME), `Alt+F12` (KDE), `Alt+F12` (Emacs), `Alt+F12` (Sublime Text), `⌥ F12` (Sublime Text (macOS)), `⌥ F12` (Xcode), `Ctrl+Alt+1` (Visual Studio), `⌘ ⌃ 1` (Visual Studio (macOS)), `Ctrl+Alt+1` (ReSharper), `⌘ ⌃ 1` (ReSharper (macOS)), `Alt+F12` (QtCreator), `⌥ F12` (QtCreator (macOS)), `Alt+F12` (NetBeans), `Alt+F12` (Eclipse), `⌥ F12` (Eclipse (macOS))）を開き、  `npm install --g express-generator` と入力して、ダウンロードしたジェネレーターを   express-generator  リストから選択します。

![特急ジェネレーターを選択](https://resources.jetbrains.com/help/img/idea/2026.3/ws_create_node_express_app_use_npx.png)

使用するテンプレート言語とスタイルシート言語を選択します。

Procedure: 空の CLion プロジェクトを作成する

1. ようこそ   画面で   新規プロジェクト   をクリックするか、メインメニューから  `ファイル | 新規 プロジェクト`  を選択します。 [新規 プロジェクト ダイアログ](null)が開きます。

2. 左側のペインで、   空の プロジェクト   を選択します。 右側のウィンドウで、アプリケーションフォルダーを指定し、   作成   をクリックします。

### 既存の Node.js アプリケーションから始める

既存の Node.js アプリケーションを引き続き開発する場合は、CLion で開いて Node.js を構成し、必要な依存関係をダウンロードします。

Procedure: すでにマシン上にあるアプリケーションソースを開く

* ようこそ   画面で   オープン   をクリックするか、メインメニューから  `ファイル | オープン`  を選択します。 開いたダイアログで、ソースが保存されているフォルダーを選択します。

Procedure: バージョン管理からアプリケーションのソースをチェックアウト

1. ようこそ   画面で   リポジトリのクローン   をクリックします。

あるいは、メインメニューから  `ファイル | 新規 | バージョン管理からプロジェクト…`  、  `Git | クローン…`  、  `VCS | バージョン管理から取得`  を選択します。

メインメニューの   Git   の代わりに、プロジェクトに関連付けられている他のバージョン管理システムが表示される場合があります。 例:   Mercurial   または   Perforce  。

2. 表示されるダイアログで、リストからバージョン管理システムを選択し、アプリケーションソースをチェックアウトするリポジトリを指定します。 詳細については、 [プロジェクトのチェックアウト (クローン)](manage-projects-hosted-on-github.html#clone-from-GitHub) を参照してください。

Procedure: プロジェクトで Node.js を構成する

1. 設定   ダイアログ（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) ）で  `言語 & フレームワーク | JavaScript ランタイム`  に移動します。

2. ノードランタイム   フィールドで、現在のプロジェクトのデフォルトの Node.js ランタイムを指定します。   ノードランタイム   リストから  `プロジェクト`  エイリアスを選択するたびに、たとえば実行/デバッグ構成作成時など、CLion は自動でこれを使用します。

リストから設定済みのランタイムを選択するか、 ![参照ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) をクリックして、 [ローカル Node.js ランタイムの構成](#ws_node_configure_local_node_interpreter)の説明に従って表示されるダイアログで新しいランタイムを設定します。   ノード   を選択した場合は、 [システム Node.js のバージョン](#ws_node_version)が使用されます。

Procedure: プロジェクトの依存関係をダウンロードする

* コマンドライン シェルまたは組み込みの   ターミナルエミュレータ  （ `Alt+F12` (Windows), `⌥ F12` (macOS), `⌥ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ T` (macOS System Shortcuts), `Alt+F12` (XWin), `Alt+F12` (GNOME), `Alt+F12` (KDE), `Alt+F12` (Emacs), `Alt+F12` (Sublime Text), `⌥ F12` (Sublime Text (macOS)), `⌥ F12` (Xcode), `Ctrl+Alt+1` (Visual Studio), `⌘ ⌃ 1` (Visual Studio (macOS)), `Ctrl+Alt+1` (ReSharper), `⌘ ⌃ 1` (ReSharper (macOS)), `Alt+F12` (QtCreator), `⌥ F12` (QtCreator (macOS)), `Alt+F12` (NetBeans), `Alt+F12` (Eclipse), `⌥ F12` (Eclipse (macOS))）で、次を入力します：

`npm install`

* または、プロジェクトルートの  `パッケージ.json​​`  ファイルのコンテキストメニューから   'npm install' の実行   を選択します。

#### プロジェクトのセキュリティ

CLion の外部で作成され、そこにインポートされたプロジェクトを開くと、CLion は、未知のソースコードを含むこのプロジェクトの処理方法を選択できるダイアログを表示します。

次のいずれかのオプションを選択します：

* セーフモードでプレビュー : この場合、CLion はプロジェクトをプレビューモードで開きます。 これは、プロジェクトのソースを参照することはできますが、タスクやスクリプトを実行したり、プロジェクトを実行 / デバッグしたりすることはできないことを意味します。 CLion はエディター領域の上部に通知を表示し、 プロジェクトを信頼する… リンクをクリックすることで、いつでもプロジェクトをロードできます。

* プロジェクトを信頼 : この場合、CLion はプロジェクトを開いてロードします。 これは、プロジェクトが初期化され、プラグインが解決され、依存関係が追加され、すべての CLion 機能が利用可能になることを意味します。

* 開かない : この場合、CLion はプロジェクトを開きません。

詳細については、 [プロジェクトのセキュリティ](project-security.html) を参照してください。

> **Tip:**
> ようこそ画面や  `ファイル｜新規｜プロジェクト`  で作成されたプロジェクトは、自動的に信頼済みと見なされます。

