运行/调试配置: Node.js
创建:
在 PyCharm 2023.3 及更高版本中,支持以下 Node.js 版本:
Node.js 22 — Active LTS 版本
Node.js 24 — 当前版本
在 支持的 Node.js 版本 了解更多信息。
在此对话框中,创建用于在您的计算机上与 Node.js 应用一同启动调试器的配置。
在开始之前
下载并安装 Node.js。
在 设置 | 插件 页面上的 插件市场 选项卡中安装 Node.js 插件,具体请参见 从 JetBrains Marketplace 安装插件。
配置选项卡
项目 | 描述 |
|---|---|
Node 运行时 | 在该字段中,指定要使用的 Node.js 运行时。 这可以是 本地 或 远程 Node.js 运行时,或 Windows Subsystem for Linux 上的 Node.js。 从列表中选择一个运行时,或点击 |
Node.js 参数 | 在此字段中,输入要传递给 Node.js 可执行文件的 Node.js 特定命令行选项。 最常见的选项包括:
有关完整列表,请参阅 Node.js 命令行选项。 |
工作目录 | 在此字段中,指定应用的 工作目录。 默认情况下,此字段显示 项目根文件夹。 |
JavaScript 文件 | 在此字段中,指定启动应用的主文件路径(例如, bin/www (适用于 Express 应用))。 如果要调试 CoffeeScript,请指定带有源映射的生成 JavaScript 文件的路径。 该文件可以通过外部生成,或通过使用 File Watchers 编译生成。 有关更多信息,请参阅 调试 CoffeeScript。 |
应用参数 | 在此字段中,输入通过 process.argv 数组在启动时传递给应用的 Node.js 特定参数。 |
环境变量 | 在该字段中,指定 Node.js 可执行文件的 环境变量 (如适用)。 点击字段右侧的 浏览
变量定义会显示在只读的 环境变量 字段中,并以分号作为分隔符,例如:
|
Docker 容器设置 | 此只读字段显示端口和卷绑定。 点击 ![]() |
Docker Compose | 在此区域中,指定要传递给 Docker Compose 的命令和选项。 接受默认设置,或点击 检查 命令预览。 |
浏览器 / Live Edit 选项卡
在此选项卡中,配置浏览器的行为,并启用对应用程序客户端代码的调试。 此功能通过 JavaScript 调试 运行配置提供。因此,从技术上讲,PyCharm 会为服务器端和客户端代码分别创建运行配置,但您在一个专用的 Node.js 运行配置中指定所有设置。
项目 | 描述 |
|---|---|
打开浏览器 | 在该区域的字段中,指定一个项目 HTML 文件,以根据项目根目录生成指向该文件的正确 URL,并在内置 Web 服务器上启动。 例如,如果您选择 project_root/inner_folder/index.html ,生成的 URL 将为 http://localhost:63342/project_root/inner_folder/index.html 。 如果选中 启动后 复选框,应用程序启动后浏览器将自动打开此页面。 或者,您也可以在所选浏览器中手动打开该 URL 地址的页面,以查看相同结果。 |
启动后 | 选中此复选框以自动打开浏览器。 在列表中,选择要使用的浏览器:
|
使用 JavaScript 调试器 | 选中此复选框以在所选浏览器中启用对客户端代码的调试。 |
V8 分析选项卡
在此选项卡中,启用 V8 CPU 和内存分析。
项目 | 描述 |
|---|---|
记录 CPU 分析信息 | 选中此复选框可在应用启动时开始记录 CPU 分析数据。 下方区域中的控件将变为可用。 指定以下内容:
|
允许获取堆快照 | 如果要运行内存分析,请选中此复选框。 |
日志选项卡
在此选项卡中,启用在 运行 工具窗口的 控制台 选项卡中显示由 morgan 等日志工具生成的信息。 有关详细信息,请参阅 运行 Node.js 应用时管理日志。
通用设置
当您编辑运行配置(而不是运行配置模板)时,可以指定以下选项:
项目 | 描述 |
|---|---|
名称(N) | 为运行配置指定名称,便于在编辑或运行时快速识别。 |
允许多个实例(U) | 允许并行运行此运行配置的多个实例。 默认情况下,该选项处于禁用状态。当您在另一个实例仍在运行时启动此配置,PyCharm 会建议先停止正在运行的实例,再启动另一个实例。 当某个运行配置占用大量资源且没有充分理由运行多个实例时,这将很有帮助。 |
存储为项目文件(S) | 将包含运行配置设置的文件保存下来,以便与团队其他成员共享。 默认位置是 .idea/runConfigurations 。 但是,如果您不想共享 .idea 目录,可以将该配置保存到项目内的任何其他目录。 默认情况下,该选项处于禁用状态,并且 PyCharm 会将运行配置设置存储在 .idea/workspace.xml 中。 |
工具栏
运行/调试配置的树形视图包含一个工具栏,可帮助您管理 您的 项目 中可用的配置,并调整默认配置模板。
项目 | 快捷方式 | 描述 |
|---|---|---|
Alt+Insert | 创建运行/调试配置。 | |
Alt+Delete | 删除选定的运行/调试配置。 请注意,您无法删除默认配置。 | |
Ctrl+D | 创建所选运行/调试配置的副本。 请注意,您将创建默认配置的副本。 | |
仅当您选择了 临时配置时,才会显示该按钮。 点击此按钮以将临时配置保存为永久配置。 | ||
移入新文件夹/创建新文件夹。 您可以通过 将其放入文件夹对运行/调试配置进行分组。 要创建文件夹,请在某个分类中选择配置,点击 随后,要将某个配置移入文件夹、在文件夹之间移动或移出文件夹,请使用拖动操作,或使用 要取消分组,请选择一个文件夹并点击 | ||
点击此按钮按字母顺序排序配置。 |
启动前
在此区域中,您可以指定在启动所选运行/调试配置之前要执行的任务。 任务按照其在列表中的顺序执行。
项目 | 快捷方式 | 描述 |
|---|---|---|
Alt+Insert | 点击该图标以添加以下可用任务之一:
| |
Alt+Delete | 点击该图标可从列表中移除所选任务。 | |
Enter | 点击该图标可编辑所选任务。 在打开的对话框中,进行必要的更改。 | |
Alt+Up Alt+Down | 点击这些图标以将所选任务在列表中上移一行或下移一行。 任务按照其在列表中的顺序执行。 | |
显示此页面 | 选中此复选框,以在实际启动运行/调试配置之前显示其设置。 | |
激活工具窗口 | 默认情况下,该复选框处于选中状态,并且当您启动运行/调试配置时,会打开 运行 或 调试 工具窗口。 否则,如果清除此复选框,将隐藏工具窗口。 但是,当配置正在运行时,您可以按 Alt+4 或 Alt+5 自行为其打开相应的工具窗口。 | |
聚焦工具窗口 |
