Node.js
Node.js 是一种轻量级运行时环境，用于在浏览器之外（例如在服务器或命令行中）执行 JavaScript。 WebStorm 集成了 Node.js，提供配置、编辑、运行、调试、测试、性能分析和维护应用的支持。
如果您仅将 Node.js 用作应用的本地运行时，或用于管理 npm 包、运行 JavaScript 代码检查器、构建工具、测试框架等，只需安装 Node.js。 如果按照标准安装流程操作，在大多数情况下 WebStorm 会自动检测 Node.js。
即使您的计算机中尚未安装 Node.js，也可以在 创建新项目对话框 中创建新的 Node.js 应用时进行安装，参见下文的 创建新的 Node.js 应用。
如果希望在多个 Node.js 安装之间切换，则必须将其配置为 本地 Node.js 解释器。 在大多数情况下，WebStorm 会检测 Node.js 安装，自动将其配置为解释器，并添加到列表中供您选择相关项。
若要远程运行 Node.js 应用，请将其配置为远程解释器。 有关详细信息，请参阅 Node.js with Docker、 Node.js via SSH 和 Node.js with Vagrant。
开始之前
请确保您的计算机上已安装 Node.js。
请确保已在设置中启用 Node.js 插件。 按 Ctrl+Alt+S 打开设置，然后选择 。 点击 已安装 选项卡。 在搜索框中输入 Node.js。 有关插件的详细信息，请参阅 Managing plugins。
在不同 Node.js 版本之间切换
使用 WebStorm，您可以拥有多个 Node.js 安装并在同一项目中切换使用。
按 Ctrl+Alt+S 打开设置，然后选择 。
从 Node 解释器 列表中选择所需的 Node.js 安装。
如果按照标准安装流程操作，在大多数情况下所需的 Node.js 安装会出现在列表中。 如果未列出该安装项，请点击
并 手动将其配置为本地解释器。
使用系统 Node.js 版本
使用 WebStorm，您可以将默认系统节点别名设置为项目的 Node.js 版本。 之后，所有需要使用 Node.js 的工具和所有新的运行/调试配置将自动使用该版本。 这意味着，如果您安装了新的 Node.js 版本并将其设置为系统中的默认节点别名，则无需为每个工具单独更新设置。
按 Ctrl+Alt+S 打开设置，然后选择 。
从 Node 解释器 列表中选择 node。
在适用位置指定此新 Node.js 解释器，例如运行/调试配置或特定工具的设置中。
配置本地 Node.js 解释器
如果 Node.js 安装在非默认路径中，导致 WebStorm 无法自动检测，您可能需要将其手动配置为解释器。
按 Ctrl+Alt+S 打开设置，然后选择 。
点击
，其位于 Node 解释器 列表旁边。在包含所有当前已配置解释器列表的 Node.js Interpreters 对话框中，点击工具栏上的
，在上下文菜单中选择 添加本地 并选择 Node.js 的安装位置，然后点击 确定。 您将返回到 Node.js Interpreters 对话框，其中的 Node 解释器 只读字段显示新解释器的路径。在 包管理器 字段中，为当前项目选择包管理器（npm、Yarn 或 pnpm）。
如需了解更多信息，请参阅 为项目配置包管理器。
点击 确定 后，您将返回 Node.js 页面，其中的 Node 解释器 字段显示新解释器。
在 Windows Subsystem for Linux 中使用 Node.js
通过 WebStorm，您可以使用 Node.js on Windows Subsystem for Linux 运行和调试 Node.js 应用。 您可以选择将 Node.js on WSL 用作 当前项目的默认解释器 ，或者在 Node.js Run/Debug 配置 中配置并使用该 Node.js 版本。
将 WSL 中的 Node.js 配置为默认项目解释器
在 设置 对话框（Ctrl+Alt+S ）中，导航到 。
点击
（位于 Node 解释器 字段旁边），在打开的 Node.js 解释器 对话框中点击 ，然后从列表中选择 添加 WSL。
在打开的 添加 WSL Node 解释器 对话框中，选择所使用的 Linux 发行版并指定 Node.js 的路径。
创建 Node.js 应用
如果尚未创建应用，您可以从模板生成具有 Node.js 特定结构的 一个 WebStorm 项目，或创建一个空的 WebStorm 项目，并按照下文 从现有 Node.js 应用入手中所述进行 Node.js 配置。
创建新的 Node.js 应用
在 欢迎 屏幕上点击 新建项目 ，或从主菜单中选择 。 将打开 新建 项目 对话框。
在左侧窗格中，选择 Node.js 创建基本的 Node.js 应用，或选择 Express 创建 Express 应用。
在右侧窗格中，指定项目文件夹和要使用的 Node.js 解释器。 如需了解详细信息，请参阅 配置本地 Node.js 解释器。
如果您的计算机上只安装了一个 Node.js，并且您按照标准安装流程操作，WebStorm 将自动检测您的 Node.js。 否则，请从列表中选择相应的解释器，参考上文 配置本地 Node.js 解释器。
如果尚未安装 Node.js，请选择 下载 Node.js。
对于 Express 应用，请在 express-generator 字段中指定 express -generator。
建议使用 npx 来下载并运行生成器。 为此，请从 express -generator 列表中选择 npx --package express-generator express。
或者，打开内嵌的 终端 （Alt+F12 ），输入
npm install --g express-generator，然后从 express-generator 列表中选择已下载的生成器。
选择要使用的模板语言和样式表语言。
单击 创建 后，WebStorm 将下载所需依赖项，并为其以及 Node.js 核心 API 启用代码补全功能。 如需了解详细信息，请参阅 配置 node_modules 库 和 配置 Node.js 核心库。
对于 Express ，WebStorm 会创建一个类型为 Node.js 的运行╱调试配置，采用默认设置，并生成 基本的 Express 特定目录结构。
对于 Node.js ，WebStorm 仅运行
npm init命令以生成 package.json 文件。
创建一个空的 WebStorm 项目
在 欢迎 屏幕上点击 新建项目 ，或从主菜单中选择 。 将打开 新建 项目 对话框。
在左侧窗格中选择 空的 项目。 在右侧窗格中，指定应用文件夹，并点击 创建。
开始使用现有的 Node.js 应用
如果您打算继续开发现有的 Node.js 应用，请在 WebStorm 中打开它，配置 Node.js，并下载所需的依赖项。
打开位于本机的应用源代码
在 欢迎 屏幕上点击 打开 ，或从主菜单中选择 。 在打开的对话框中，选择保存源代码的文件夹。
从版本控制中签出应用源代码
在 欢迎 屏幕上点击 克隆版本库克隆。
或者，从主菜单中选择 、 或 。
在主菜单中，您可能看到与项目关联的其他版本控制系统，而非 Git。 例如， Mercurial 或 Perforce。
在打开的对话框中，从列表中选择您的版本控制系统，并指定要从中检出应用源代码的存储库。 如需了解详细信息，请参阅 检出项目（克隆）。
在项目中配置 Node.js
在 设置 对话框（Ctrl+Alt+S ）中，转到 。
在 Node 解释器 字段中，为当前项目指定默认的 Node.js 解释器。 每当您从 Node 解释器 列表中选择
Project别名时，WebStorm 都会自动使用该解释器，例如在创建运行／调试配置时。从列表中选择一个已配置的解释器，或点击
，并按照 配置本地 Node.js 解释器 中所述内容，在打开的对话框中配置新解释器。 如果选择 node ，将使用 系统 Node.js 版本。选中 Node.js 的代码辅助 复选框，以将 Node.js Core 模块源配置为 JavaScript 库 ，并将其关联到您的项目。 由此，WebStorm 将为
fs、path、http以及编译进 Node.js 可执行文件的其他部分提供代码补全、引用解析、校验与调试功能。配置完成后，WebStorm 将显示当前配置版本的信息。
如果您只需要在项目的某些部分使用 Node.js API 的代码补全功能，可以使用 管理作用域 链接进行配置。 在打开的 使用范围对话框 中，点击相关目录并为各个目录从列表中选择已配置的 Node.js Core 库。 详细信息请参见 配置库的作用域。
下载项目依赖
在嵌入式 终端 （Alt+F12 ）中，键入：
npm install或者，从项目根目录中 package.json 文件的上下文菜单中选择 运行 'npm install'。
项目安全性
当您打开一个在 WebStorm 外部创建并导入至 WebStorm 的项目时，WebStorm 会显示一个对话框，您可以决定如何处理该含有非熟悉源代码的项目。
请选择以下选项之一：
以安全模式预览 ：在此情况下，WebStorm 将以预览模式打开项目。 这意味着您可以浏览项目的源代码，但无法运行任务与脚本或运行／调试项目。
WebStorm 会在编辑器区域顶部显示通知，您可以随时点击 信任项目… 链接以加载项目。
信任项目 ：在此情况下，WebStorm 将打开并加载项目。 这意味着项目被初始化、插件已解析、依赖项已添加，且所有 WebStorm 功能均可使用。
不打开 ：在此情况下，WebStorm 不会打开项目。
详情请参见 项目安全性。