Node.js
Node.js 是一个轻量级运行时环境,用于在浏览器之外执行 JavaScript,例如在服务器或命令行中。 GoLand 与 Node.js 集成,可协助配置、编辑、运行、调试、测试、分析性能及维护应用程序。
如果您仅将 Node.js 用作应用程序的本地运行时,或用于管理 npm 包、运行 JavaScript linter、构建工具、测试框架等,只需安装 Node.js。 如果您按照标准安装流程操作,GoLand 在大多数情况下可自动检测 Node.js。
即使您的计算机上尚未安装 Node.js,也可以在 创建新项目对话框 中创建新的 Node.js 应用程序时进行安装,详见下文 创建新的 Node.js 应用程序。
如果想在多个 Node.js 安装之间切换,则必须将它们配置为 本地 Node.js 解释器。 在大多数情况下,GoLand 会自动检测 Node.js 安装,将其配置为解释器,并将其添加到列表中,供您选择所需版本。
要远程运行 Node.js 应用程序,请将其配置为远程解释器。 有关详细信息,请参见 Node.js with Docker、 Node.js via SSH 和 Node.js with Vagrant。
开始之前
下载并安装 Node.js。
请确保在设置中启用了 JavaScript 和 TypeScript 插件。 按 Ctrl+Alt+S 打开设置,然后选择 。 点击 已安装 标签页。 在搜索字段中键入 JavaScript 和 TypeScript。 有关插件的更多信息,请参见 管理插件。
请在 设置 | 插件 页面、 Marketplace 标签页中安装并启用 Node.js 插件,具体操作请参见 从 JetBrains Marketplace 安装插件。
在 Node.js 版本之间切换
借助 GoLand,您可以拥有多个 Node.js 安装,并在同一项目中切换使用。
按 Ctrl+Alt+S 打开设置,然后选择 。
从 Node 解释器 列表中选择所需的 Node.js 安装。
如果按照标准安装流程操作,所需的 Node.js 安装在大多数情况下会出现在列表中。 如果列表中没有该安装,请点击
,然后 手动配置为本地解释器。
使用系统 Node.js 版本
使用 GoLand,可以将默认系统节点别名设置为项目使用的 Node.js 版本。 之后,此版本将自动用于所有需要 Node.js 的工具以及所有新的运行/调试配置中。 特别地,这意味着如果安装新版本 Node.js 并将其设为系统默认节点别名,则无需为每个工具逐一更新设置。
按 Ctrl+Alt+S 打开设置,然后选择 。
从 Node 解释器 列表中,选择 node。

在适用的位置指定此新的 Node.js 解释器,例如运行/调试配置或特定工具的设置中。
配置本地 Node.js 解释器
您可能需要手动将 Node.js 安装配置为解释器,例如在 Node.js 安装在非默认位置且 GoLand 未能自动检测到的情况下。
按下 Ctrl+Alt+S 打开设置,然后选择 。
点击
,该按钮位于 Node 解释器 列表旁。
在 Node.js 解释器 对话框中列出了所有当前已配置的解释器,在工具栏上点击
,然后从上下文菜单中选择 添加本地 并选择 Node.js 的安装路径,然后点击 确定。 您将返回 Node.js 解释器 对话框,其中的 Node 解释器 只读字段显示新解释器的路径。
在 包管理器 字段中,为当前项目选择要使用的包管理器(npm、Yarn 或 pnpm)。
如需了解详情,请参阅 为项目配置包管理器。
当您点击 确定 时,将返回 Node.js 页面,并在 Node 解释器 字段中显示新的解释器。
在 Windows 子系统 Linux 上使用 Node.js
GoLand 允许您使用 Windows Subsystem for Linux 中的 Node.js 运行并调试 Node.js 应用程序。 您可以选择将 WSL 中的 Node.js 设置为 当前项目的默认解释器 ,或者在 Node.js 运行/调试配置中配置并使用此 Node.js 版本。
将 WSL 中的 Node.js 配置为默认项目 Node.js 解释器
在 设置 对话框(Ctrl+Alt+S )中,转到 。
点击
,该按钮位于 Node 解释器 字段旁,在打开的 Node.js 解释器 对话框中点击
,然后从列表中选择 添加 WSL。

在打开的 添加 WSL Node 解释器 对话框中,选择您使用的 Linux 发行版并指定 Node.js 的路径。

创建 Node.js 应用程序
如果您尚未创建任何应用程序,可以从模板生成包含 Node.js 特定结构的 一个 GoLand 项目,或者创建一个空的 GoLand 项目,并按照下文中的 使用现有 Node.js 应用程序开始开发进行配置。
创建新的 Node.js 应用程序
点击主菜单中的 。 或者,点击欢迎屏幕中的 。
在左侧窗格中,选择 Node.js 创建基础 Node.js 应用程序,或选择 Express 创建 Express 应用程序。
在右侧窗格中,指定项目文件夹和要使用的 Node.js 解释器。 如需了解详情,请参阅 配置本地 Node.js 解释器。
如果您的计算机上只安装了一个 Node.js,并且您遵循标准安装程序安装,GoLand 将自动检测到您的 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 列表中选择已下载的生成器。
选择要使用的模板语言和样式表语言。
当您点击 创建 后,GoLand 将下载所需的依赖项,并为它们及 Node.js 核心 API 启用代码补全功能。 如需了解详情,请参阅 配置 node_modules 库 和 配置 Node.js 核心库。
对于 Express ,GoLand 将创建一个类型为 Node.js 、具有默认设置的运行/调试配置,并生成一个 基础 Express 特定目录结构。
对于 Node.js ,GoLand 仅运行
npm init命令来生成 package.json 文件。
创建空的 GoLand 项目
点击主菜单中的 。 或者点击欢迎屏幕中的 。
在左侧窗格中,选择 空 项目。 在右侧窗格中,指定应用程序文件夹并点击 创建。
从现有 Node.js 应用程序开始
如果您要继续开发现有的 Node.js 应用程序,请在 GoLand 中打开该项目,配置 Node.js 并下载所需的依赖项。
打开已存在于本机上的应用程序源代码
点击 打开 ,该按钮位于 欢迎 屏幕上,或从主菜单中选择 。 在打开的对话框中,选择存放源代码的文件夹。
从版本控制中检出应用程序源代码
点击 克隆 ,该按钮位于 欢迎 屏幕上。
或者,从主菜单中选择 或 。
主菜单中显示的可能不是 Git ,而是任何与您的项目相关联的版本控制系统。 例如, Mercurial 或 Perforce。

在项目中配置 Node.js
在 设置 对话框(Ctrl+Alt+S )中,转到 。
在 Node 解释器 字段中,为当前项目指定默认的 Node.js 解释器。 每次从 Node 解释器 列表中选择
项目别名时,GoLand 会自动使用该解释器,例如创建运行/调试配置时。从列表中选择一个已配置的解释器,或点击
,并按照 配置本地 Node.js 解释器 中所述,在打开的对话框中配置新的解释器。 如果选择 node ,将使用 系统 Node.js 版本。
选中 Node.js 编码辅助 复选框,以将 Node.js Core 模块源配置为 JavaScript 库 并将其关联到您的项目中。 因此,GoLand 会为
fs、path、http以及编译到 Node.js 可执行文件中的其他部分提供代码补全、引用解析、验证和调试功能。配置完成后,GoLand 会显示当前所配置版本的信息。
如果仅需在项目的某些部分使用 Node.js API 的代码补全功能,可使用 管理作用域 链接进行配置。 在打开的 使用范围对话框 中,点击相关目录,并为每个目录从列表中选择已配置的 Node.js Core 库。 详细了解请参见 配置库的使用范围。
下载项目依赖项
在嵌入式 终端 (Alt+F12 )中键入以下命令:
npm install或者,从项目根目录中 package.json 文件的上下文菜单中选择 运行 'npm install'。
项目安全性
当打开一个在 GoLand 外部创建并导入到其中的项目时,GoLand 会显示一个对话框,您可以在其中决定如何处理该包含不熟悉源代码的项目。

请选择以下选项之一:
以安全模式预览 :在这种情况下,GoLand 以预览模式打开项目。 这意味着您可以浏览项目源代码,但无法运行任务与脚本,或运行/调试项目。
GoLand 会在编辑器区域顶部显示通知,您可以随时点击 信任项目… 链接加载项目。
信任项目 :在这种情况下,GoLand 会打开并加载项目。 这意味着项目会被初始化,项目插件会解析,依赖项会添加,并启用 GoLand 的所有功能。
不打开 :在这种情况下,GoLand 不会打开该项目。
详细了解请参见 项目安全。