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 安装之间切换,则它们必须配置为 local Node.js interpreters。 在大多数情况下,IntelliJ IDEA 会检测 Node.js 安装,自动将其配置为解释器,并将其添加到您可以选择相关解释器的列表中。
要远程运行 Node.js 应用程序,请将其配置为远程解释器。 有关更多信息,请参考 使用 Docker 的 Node.js、 通过 SSH 的 Node.js和 使用 Vagrant 的 Node.js。
开始之前
在 Node.js 版本之间切换
通过 IntelliJ IDEA,您可以安装多个 Node.js,并在同一个项目中切换使用不同版本。
按 Ctrl+Alt+S 打开设置,然后选择 。
从 Node 解释器 列表中选择所需的 Node.js 安装。
如果您按照标准安装程序进行操作,在大多数情况下,所需的 Node.js 安装会在列表中。 如果缺少安装,请点击
并 手动将其配置为本地解释器。
使用系统 Node.js 版本
使用 IntelliJ IDEA,您可以将默认系统节点别名设置为您的项目的 Node.js 版本。 之后,该版本将自动用于所有需要 Node.js 的工具,以及所有新的运行/调试配置。 这意味着, 如果您安装了新的 Node.js 版本并将其设置为系统中的默认节点别名, 您将无需更新每个工具的设置。
按 Ctrl+Alt+S 打开设置,然后选择 。
从 Node 解释器 列表中选择 节点。

请在适用的地方指定这个新的 Node.js 解释器,例如在您的运行/调试配置或特定工具的设置中。
配置本地 Node.js 解释器
如果 Node.js 安装在非默认位置并且 IntelliJ IDEA 无法自动检测到,您可能需要手动配置 Node.js 安装作为解释器。
按 Ctrl+Alt+S 打开设置,然后选择 。
点击
旁边的 Node 解释器 列表。
在包含所有当前配置的解释器列表的 Node.js Interpreters对话框中,点击工具栏上的
,并从上下文菜单中选择 添加本地 ,然后选择 Node.js 的安装,最后点击 OK。 您返回到 Node.js Interpreters 对话框,此时 Node 解释器 只读字段显示新解释器的路径。
在 软件包管理器 字段中,为当前项目选择包管理器(npm、Yarn 或 pnpm)。
如需更多信息,请参阅 为项目配置软件包管理器。
当您点击 OK 时,您将返回 Node.js 页面, Node 解释器 字段将显示新的解释器。
在 Windows Subsystem for Linux 上使用 Node.js
IntelliJ IDEA 允许您使用 Node.js on Windows Subsystem for Linux 运行和调试 Node.js 应用程序。 您可以在 WSL 上选择 Node.js 作为 当前项目的默认解释器 ,或者您可以在 Node.js 运行/调试配置中配置并使用此 Node.js 版本。
在 WSL 上配置 Node.js 作为默认项目节点解释器
在 设置 对话框(Ctrl+Alt+S )中,前往 。
点击
旁边的 Node 解释器 字段,在打开的 Node.js 解释器 对话框中,点击
,然后从列表中选择 添加 WSL。

在打开的 添加 WSL Node 解释器 对话框中,选择您正在使用的 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 ,它会下载并运行生成器。 为此,请从 npx --package express-generator express 列表中选择 express -generator。
或者,打开嵌入的 终端 (Alt+F12 ),输入
npm install --g express-generator,然后从 express-generator 列表中选择下载的生成器。
选择要使用的模板语言和样式表语言。
当您点击 创建 时,IntelliJ IDEA 会下载必要的依赖项,并为它们以及 Node.js 核心 API 启用代码补全。 有关更多信息,请参阅 Configuring node_modules library和 Configuring Node.js Core library。
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 解释器 字段中,指定当前项目的默认 Node.js 解释器。 每当您从 Node 解释器 列表中选择
项目别名时,例如创建运行/调试配置时,IntelliJ IDEA会自动使用它。从列表中选择一个已配置的解释器,或点击
并在打开的对话框中配置一个新的解释器,如 配置本地 Node.js 解释器中所述。 如果选择 节点 ,将使用 系统 Node.js 版本。
选中 Node.js 编码协助 复选框,以将 Node.js Core模块源配置为 JavaScript 库 ,并将其与您的项目关联。 因此,IntelliJ IDEA 提供了代码补全、引用解析、验证以及调试功能用于
fs、path、http以及编译成 Node.js 二进制文件的 Node.js 其他部分。配置完成后,IntelliJ IDEA 会显示当前配置版本的信息。
如果您只需要在项目的某些部分为 Node.js API 提供代码补全,您可以使用 管理作用域 链接进行配置。 在打开的 用法对话框中,点击相关目录,并为每个目录从列表中选择配置的 Node.js Core 库。 了解更多信息,请参阅 配置库的范围。
下载项目依赖项
在嵌入的 终端 (Alt+F12 )中输入:
npm install或者,从项目根目录中选择 运行“npm install” 文件的上下文菜单中的 package.json 。
项目安全性
当您打开一个在 IntelliJ IDEA 之外创建并导入其中的项目时,IntelliJ IDEA 会显示一个对话框,您可以在其中决定如何处理这个不熟悉的源代码项目。
请选择以下选项之一:
安全模式预览 :在这种情况下,IntelliJ IDEA 以预览模式打开项目。 这意味着您可以浏览项目的源代码,但无法运行任务和脚本或运行/调试您的项目。
IntelliJ IDEA 会在编辑器区域顶部显示通知,您可以随时点击 信任项目… 链接并加载您的项目。
信任项目 :在这种情况下,IntelliJ IDEA 会打开并加载一个项目。 这意味着项目已初始化,项目的插件已解析,依赖项已添加,并且所有 IntelliJ IDEA 功能均可用。
不要打开 :在这种情况下,IntelliJ IDEA 不会打开项目。
了解更多 项目安全性。