# JavaScript 运行时环境

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

> **TL;DR**
> `文件 | 设置 | 语言与框架 | JavaScript 运行时`  适用于 Windows 和 Linux
>
>
>
> `%instance% | 设置 | 语言与框架 | JavaScript 运行时`  适用于 macOS
>
>
>
> `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)) !["设置"图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg)
>
>
>
> 所需插件：
>
>
>
> JavaScript 和 TypeScript   -  插件与 IntelliJ IDEA 捆绑在一起，并默认启用。
>
>
>
> Node.js  （仅用于开发 Node.js 应用程序） -  在   设置 | 插件   页面上安装插件。 该插件仅在拥有 Ultimate 订阅的 IntelliJ IDEA 中可用。

## 首选运行时

在此区域，选择要使用的运行时。 可用的运行时取决于已安装的插件。

## 包管理器

在此字段中，为当前项目选择 包管理器 (npm、Yarn、pnpm、bun)。

IntelliJ IDEA 使用  `npm` 、  `yarn` 、  `pnpm`  和  `Bun`  别名来指向这些管理器的当前系统路径。 要使用自定义安装，请点击   选择  ，然后选择相应包管理器的安装文件夹。 有关详细信息，请参阅 [为项目配置包管理器](installing-and-removing-external-software-using-node-package-manager.html#ws_npm_yarn_configure_package_manager)。

默认情况下，IntelliJ IDEA 建议使用 npm。 但是，如果您打开的项目包含  `yarn.lock`  文件，并且您的计算机上已安装 Yarn，IntelliJ IDEA 会自动将该项目的包管理器更改为 Yarn。

同理，如果您打开的项目包含  `pnpm-lock`  文件，并且您的计算机上已安装 pnpm，IntelliJ IDEA 会自动将该项目的包管理器更改为 pnpm。

您还可以 [将 Yarn 1 或 pnpm 设为 IntelliJ IDEA 的默认包管理器](installing-and-removing-external-software-using-node-package-manager.html#ws_npm_yarn_set_yarn_default)。

## Node.js

在此区域，指定在项目中使用的 Node.js 运行时，并启用特定于 Node.js 的代码辅助功能。

要了解如何使用  Node.js ，请参阅 [开发 Node.js 应用程序](developing-node-js-applications.html)部分。

### Node.js 运行时

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

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

您可以选择或配置以下类型之一的运行时：

* 本地解释器 — 安装在您计算机上的 Node.js。 详细了解请参阅 [配置本地 Node.js 运行时](developing-node-js-applications.html#ws_node_configure_local_node_interpreter)。

* [适用于 Linux 的 Windows 子系统上的 Node.js](https://docs.microsoft.com/en-us/windows/wsl/about)，详细了解请参阅 [在适用于 Linux 的 Windows 子系统上使用 Node.js](developing-node-js-applications.html#ws_node_wsl)。

* 远程解释器 — 远程主机或虚拟环境中的 Node.js。 详细了解请参阅 [使用 Docker 的 Node.js](node-with-docker.html)、 [通过 SSH 的 Node.js](node-via-ssh.html) 和 [使用 Vagrant 的 Node.js](null)。

### 版本

此只读字段显示所选 Node.js 的版本。

在 IntelliJ IDEA 2023.3 及以后版本中，支持以下 Node.js 版本：

* Node.js 22 - 当前长期支持（ LTS ）版本

* Node.js 24 - 当前版本

了解详情，请参阅 [支持的 Node.js 版本](supported-node-js-versions.html)

### 为 Node.js 提供编码辅助

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

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

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

## Bun

> **Note:**
> 仅当  Bun  插件安装在   设置 | 插件   页面上时，该区域才可用，相关说明请参阅 [从 JetBrains Marketplace 安装插件](managing-plugins.html#install_plugin_from_repo)。

在此区域，指定 Bun 可执行文件的路径。

Bun 可执行文件的路径默认为  `路径`  环境变量，因此如果将   Bun   字段留空，调试器会尝试自动检测 Bun 可执行文件。

## Deno

> **Note:**
> 仅当  Deno  插件安装在   设置 | 插件   页面上时，该区域才可用，相关说明请参阅 [从 JetBrains Marketplace 安装插件](managing-plugins.html#install_plugin_from_repo)。

## See also

### 语言和框架特定指南

[npm、pnpm 和 Yarn](installing-and-removing-external-software-using-node-package-manager.html) [Node.js](developing-node-js-applications.html)