# Node.js

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

> **TL;DR**
> 所需插件  :
>
>
>
> `JavaScript 和 TypeScript`  -  插件与 IntelliJ IDEA 捆绑在一起，并默认启用。

[Node.js](http://nodejs.org/) 是一个轻量级的运行环境，用于在浏览器外部执行 JavaScript，例如在服务器上或命令行中。 IntelliJ IDEA 与 Node.js 集成，提供配置、编辑、运行、调试、测试、性能分析和维护您的应用程序的帮助。

如果您只需要 Node.js 作为应用程序的本地运行时或用于管理 npm 包、运行 JavaScript 检查工具、构建工具、测试框架等，只需安装 [Node.js](http://nodejs.org/#download)。 如果您遵循标准安装程序，大多数情况下 IntelliJ IDEA 会自行检测 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)。 在大多数情况下， IntelliJ IDEA 会检测到 Node.js 安装，自动将其配置为运行时，并将其添加到列表中，您可以在其中选择相关项。

要远程运行 Node.js 应用，请将其配置为远程运行时。 有关更多信息，请参考 [使用 Docker 的 Node.js](node-with-docker.html)、 [通过 SSH 的 Node.js](node-via-ssh.html)和 [使用 Vagrant 的 Node.js](null)。

## 开始之前

Procedure:

1. 下载并安装 [Node.js](http://nodejs.org/#download)。

2. 请确保已在设置中启用  JavaScript 和 TypeScript  插件。 按 `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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))打开设置，然后选择  `插件` 。 在搜索字段中，键入  JavaScript 和 TypeScript 。 有关插件的更多信息，请参阅 [管理插件](managing-plugins.html)。

3. 按照 [从 JetBrains Marketplace 安装插件](managing-plugins.html#install_plugin_from_repo)中所述，在   设置 | 插件  页面上安装并启用  Node.js 插件。 该插件仅在拥有 Ultimate 订阅的 IntelliJ IDEA 中可用。

## 在多个 Node.js 安装之间切换

通过 IntelliJ IDEA，您可以安装多个 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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (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 版本

借助 IntelliJ IDEA，您可以将系统默认的  `node`  别名设置为项目的 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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `语言与框架 | JavaScript 运行时` 。

2. 请确保在   Node.js   字段中选择了   首选运行时  。

3. 从   Node.js 运行时   列表中选择   node  。

4. 在适用的位置指定此新的 Node.js 运行时，例如，在运行/调试配置或特定工具的设置中。

## 配置本地 Node.js 运行时

您可能需要将 Node.js 安装手动配置为运行时。例如，如果 Node.js 安装在非默认位置， IntelliJ IDEA 将无法自动检测到它。

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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `语言与框架 | JavaScript 运行时` 。

2. 请确保在   Node.js   字段中选择了   首选运行时  。

3. 在   Node.js 运行时   列表旁边点击 ![浏览按钮](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) 对话框，其中的   Node.js 运行时   只读字段显示新运行时的路径。

5. 在   包管理器   字段中，为当前项目选择包管理器（ npm、Yarn、pnpm、bun ）。

如需更多信息，请参阅 [为项目配置软件包管理器](installing-and-removing-external-software-using-node-package-manager.html#ws_npm_yarn_configure_package_manager)。

点击   OK   后，您将返回到   JavaScript 运行时   页面，其中的   Node.js 运行时   字段显示新运行时。

## 在 Windows Subsystem for Linux 上使用 Node.js

IntelliJ IDEA 允许您使用 [Node.js on Windows Subsystem for Linux](https://docs.microsoft.com/en-us/windows/wsl/about) 运行和调试 Node.js 应用程序。 您可以将 WSL 上的 Node.js 选择为 [当前项目的默认运行时](#ws_default_project_node_interpreter)，也可以在 [Node.js 运行/调试配置](running-and-debugging-node-js.html#Node.js_run) 中配置并使用该 Node.js 版本。

> **Warning:**
> 在 WSL 上使用 Node.js 调试应用程序仅在 IntelliJ IDEA Ultimate 中可用： [下载](https://www.jetbrains.com/zh-cn/idea/download/)试用或 [比较版本](https://www.jetbrains.com/zh-cn/products/compare/?product=idea&product=idea-ce)

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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))），转到  `语言与框架 | JavaScript 运行时` 。

2. 点击 ![浏览按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg)，该控件位于   Node.js 运行时   字段旁；在打开的   Node.js 运行时   对话框中，点击 !["添加"按钮](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 Node.js 运行时  对话框中，选择您正在使用的 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 特定结构的 一个 IntelliJ IDEA 项目或创建一个空的 IntelliJ IDEA 项目，并按照下面 [从现有 Node.js 应用程序开始](#ws_node_quick_start_with_an_existing_app) 的描述配置 Node.js。

您还可以从现有的 Node.js 应用程序创建模块。

Procedure: 创建一个新的 Node.js 应用程序

1. 从主菜单中选择  `文件 | 新建 | 项目` ，或者在   %instance% 主页   屏幕上点击  `新建 | 项目` 。

2. 在   新建项目   对话框的左侧窗格中，选择   Express  。

3. 在右侧窗格中，指定项目文件夹和要使用的 Node.js 运行时。 有关更多信息，请参见 [配置本地 Node.js 运行时](#ws_node_configure_local_node_interpreter)。

请在   express-generator  字段中的 [express -generator](https://www.npmjs.com/package/express-generator)指定。

建议您使用 [npx](https://www.npmjs.com/package/npx)，它会下载并运行生成器。 为此，请从   npx --package express-generator express   列表中选择   express -generator  。

或者，打开命令行 shell 或嵌入的   终端  （ `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)), `Ctrl+Alt+1` (Visual Studio), `⌘ ⌃ 1` (Visual Studio (macOS)), `Alt+F12` (NetBeans), `Alt+F12` (Eclipse), `⌥ F12` (Eclipse (macOS))），输入  `npm install --g express-generator` ，然后从   express-generator  列表中选择下载的生成器。

![选择 express generator](https://resources.jetbrains.com/help/img/idea/2026.3/ws_create_node_express_app_use_npx.png)

选择要使用的模板语言和样式表语言。

4. 当您点击   创建   时，IntelliJ IDEA 会下载必要的依赖项，并为它们以及 Node.js 核心 API 启用代码补全。 有关更多信息，请参阅 [Configuring node_modules library](configuring-javascript-libraries.html#ws_js_libraries_examples_node_modules)和 [Configuring Node.js Core library](configuring-javascript-libraries.html#ws_js_libraries_node_js_core)。

IntelliJ IDEA 创建了一个类型为  Node.js  的运行/调试配置，并生成了一个 [基本的 Express 特定目录结构](https://expressjs.com/en/starter/generator.html#previous-hello-world-next-basic-routing)。

Procedure: 创建一个空的 IntelliJ IDEA 项目

1. 从主菜单中选择  `文件 | 新建 | 项目` ，或者在   %instance% 主页   屏幕上点击  `新建 | 项目` 。

2. 在   新建项目   对话框的左侧窗格中，选择   新建项目  。

3. 在右侧窗格中，选择   JavaScript   在   语言   区域中，并指定项目文件夹和名称。

若要生成示例应用程序，请勾选   添加示例代码  复选框。

Procedure: 从现有的 Node.js 应用创建模块

1. 下载您的应用程序源代码并将其存储在您的计算机上。

2. 前往  `文件 | 新建 | 从现有源创建模块` 。

3. 在打开的对话框中，选择您的应用程序源代码位置。

有关更多信息，请参阅 [模块](creating-and-managing-modules.html)。

### 从现有的 Node.js 应用程序开始

如果您将继续开发现有的 Node.js 应用程序，请在 IntelliJ IDEA 中打开它，配置 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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))），转到  `语言与框架 | JavaScript 运行时` 。

2. 在   Node.js 运行时   字段中，指定当前项目的默认 Node.js 运行时。 每当您从   Node.js 运行时  列表中选择  `项目` 别名时，例如创建运行/调试配置时，IntelliJ IDEA会自动使用它。

从列表中选择已配置的运行时，或点击 ![浏览按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) 并在打开的对话框中按照 [配置本地 Node.js 运行时](#ws_node_configure_local_node_interpreter) 中的说明配置一个新的运行时。 如果您选择   node  ，将使用 [系统 Node.js 版本](#ws_node_version)。

3. 选中   为 Node.js 提供编码辅助  复选框，以将  Node.js Core 模块源配置为 [JavaScript 库](configuring-javascript-libraries.html#ws_js_libraries_node_js_core)，并将其与您的项目关联。 因此，IntelliJ IDEA 提供了代码补全、引用解析、验证以及调试功能用于  `fs` 、  `路径` 、  `http`  以及编译成 Node.js 二进制文件的 Node.js 其他部分。

配置完成后，IntelliJ IDEA 会显示当前配置版本的信息。

4. 如果只需要在项目的某些部分为 Node.js API 提供代码补全，可以使用   管理作用域   链接进行配置。 在打开的 [用法对话框](null) 中，点击相关目录，并为每个目录从列表中选择已配置的 Node.js Core 库。 请参阅 [配置库的作用域](configuring-javascript-libraries.html#ws_js_configuring_js_libs_change_scope) 了解详情。

Procedure: 下载项目依赖项

* 在命令行 shell 或嵌入式   终端  （ `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)), `Ctrl+Alt+1` (Visual Studio), `⌘ ⌃ 1` (Visual Studio (macOS)), `Alt+F12` (NetBeans), `Alt+F12` (Eclipse), `⌥ F12` (Eclipse (macOS))）中输入：

`npm install`

* 或者，从项目根目录下  `package.json`  文件的上下文菜单中选择   运行 'npm install'  。

#### 项目安全

打开在 IntelliJ IDEA 外部创建并导入其中的项目时，IntelliJ IDEA 会显示一个对话框，可在其中决定如何处理此包含不熟悉源代码的项目。

请选择以下选项之一：

* 在安全模式中预览 ：在这种情况下，IntelliJ IDEA 以预览模式打开项目。 这意味着可以浏览项目的源代码，但无法运行任务和脚本，也无法运行/调试项目。 IntelliJ IDEA 会在编辑器区域顶部显示一条通知，可以点击 信任项目… 链接随时加载项目。

* 信任项目 ：在这种情况下，IntelliJ IDEA 会打开并加载一个项目。 这意味着项目已初始化，项目的插件已解析，依赖项已添加，并且所有 IntelliJ IDEA 功能都可用。

* 不打开 ：在这种情况下，IntelliJ IDEA 不会打开项目。

有关更多信息，请参阅 [项目安全](project-security.html)。

> **Tip:**
> 从欢迎屏幕或通过  `文件 | 新建 | 项目`  创建的项目会被自动视为受信任。

## See also

### 过程

[JavaScript](javascript-specific-guidelines.html) [配置 JavaScript 库](configuring-javascript-libraries.html) [CoffeeScript](coffeescript.html)

### 参考

[插件](plugins-settings.html) [JavaScript 运行时环境](javascript-runtime.html) [运行/调试配置：Node.js](run-debug-configuration-node-js.html) [运行/调试配置：连接到 Node.js/Chrome](run-debug-configuration-node-js-remote-debug.html) [运行/调试配置：NodeUnit](run-debug-configuration-nodeunit.html)

### 外部链接

[http://nodejs.org](http://nodejs.org)