运行/调试配置:NPM
创建:
在此对话框中,创建用于在本地运行 npm 和 Yarn 脚本的配置。 "本地" 在当前上下文中表示 PyCharm 本身会启动安装在您计算机上的 Node.js ,随后启动脚本执行。
在 npm、pnpm 和 Yarn 了解更多信息。
如果脚本以开发模式启动应用,您可以修改该配置,使其同时启动调试会话。 为此,请转到 浏览器 / Live Edit 选项卡 并在其中指定应用将运行的 URL 地址。 了解更多信息,请参阅 使用单个 npm 运行/调试配置运行和调试 Angular 应用程序、 使用单个 npm 运行/调试配置运行并调试 Vue.js 应用 和 使用单个 npm 运行/调试配置运行并调试 Vite 应用。
在开始之前
配置选项卡
项目 | 描述 |
|---|---|
package.json | 在此字段中,指定用于运行脚本的 package.json 文件。 从下拉列表中选择文件,该列表显示当前项目中检测到的所有 package.json 文件,或点击 |
Command | 从此列表中,选择要执行的 npm CLI 命令 ,默认选择 |
脚本 | 从此下拉列表中,选择要应用所选命令的脚本。 该列表包含在 package.json 文件的 |
参数 | 在此字段中,指定用于执行脚本的命令行参数。 详细了解请参阅 npm 官方网站。 |
Node 运行时 | 在该字段中,指定要使用的 Node.js 运行时。 如果您选择 项目 别名, PyCharm 将自动使用 JavaScript 运行时 页面中 Node 运行时 字段的项目默认解释器。 在大多数情况下, PyCharm 会检测项目默认运行时并自行填写该字段。 您还可以选择另一个已配置的本地或远程解释器,或点击 |
Node 选项 | 在此字段中,输入要传递给 Node.js 可执行文件的 Node.js 特定命令行选项。 可接受的选项为:
|
包管理器 | 指定要使用的软件包管理器。 如果您选择 |
环境变量 | 在此字段中,为 Node.js 可执行文件指定自定义 环境变量。 变量定义会显示在 环境变量 字段中,并以分号(
![]() 或者,点击字段右侧的 浏览
|
Docker 容器设置 | 此只读字段显示端口和卷绑定。 点击 ![]() |
Docker Compose | 在此区域中,指定要传递给 Docker Compose 的命令和选项。 接受默认设置,或点击 检查 命令预览。 |
通用设置
当您编辑运行配置(而不是运行配置模板)时,可以指定以下选项:
项目 | 描述 |
|---|---|
名称 | 为运行配置指定名称,便于在编辑或运行时快速识别。 |
允许多个实例。 | 允许并行运行此运行配置的多个实例。 默认情况下,该选项处于禁用状态。当您在另一个实例仍在运行时启动此配置,PyCharm 会建议先停止正在运行的实例,再启动另一个实例。 当某个运行配置占用大量资源且没有充分理由运行多个实例时,这将很有帮助。 |
存储为项目文件 | 将包含运行配置设置的文件保存下来,以便与团队其他成员共享。 默认位置是 .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 自行为其打开相应的工具窗口。 | |
聚焦工具窗口 |
浏览器 / Live Edit 选项卡
如果您希望运行/调试配置在开发模式下启动应用,并同时开始调试会话,请使用此选项卡中的控件。 从 使用单个 npm 运行/调试配置运行和调试 Angular 应用程序、 使用单个 npm 运行/调试配置运行并调试 Vue.js 应用 和 使用单个 npm 运行/调试配置运行并调试 Vite 应用 了解更多。
在这里,您还可以启用 PyCharm 在浏览器中打开应用。
项目 | 描述 |
|---|---|
打开浏览器 | 在此区域中,启用应用在浏览器中打开。
|
步进选项卡
在此选项卡上,指定 步进选项。
某些脚本会被 步入 跳过,因为通常不需要对它们进行调试。 您可以在 设置 对话框(Ctrl+Alt+S )的 页面上微调此列表。
打开运行/调试配置以启动调试会话并切换到 步进 选项卡。
要禁止自动 智能步入 ,请清除 始终执行智能步入 复选框。
要跳过源代码映射的
ignoreList字段中的脚本,请选中 忽略源代码映射中指定的已知第三方脚本 复选框。较旧的 Chrome 专用字段名称
x_google_ignoreList已弃用,但在缺少ignoreList字段时可能仍会被识别。 从 源代码映射规范了解详情。要禁止步入自定义脚本,请选中 不要步入 URL 与以下模式匹配的脚本 复选框,并展开下方此类脚本的默认列表。 使用
*、?、**和!。
模式语法
模式中支持以下字符:
星号
*匹配除斜杠/以外的零个或多个字符。 请在单个路径部分内使用此字符。问号
?精确匹配除斜杠/以外的一个字符。作为完整段的双星号
**匹配零个或多个路径段。 其含义取决于其位置:作为第一部分时,它匹配任意前导符号。
作为最后一部分时,它匹配任意尾随符号。
在中间时,它匹配一个或多个部分。 例如,
a/**/b匹配a/x/b和a/x/y/b,但不匹配a/b。
最后一个段末尾的尾随双星号
**(不是单独作为完整段,例如foo**)匹配该段之后的任意后缀。 例如,foo**匹配foo、foobar和foo/bar。以感叹号
!开头的模式会否定给定模式,并修改列表中在它之前添加的模式。 它本身不会添加新模式。
- 示例 1
在模式列表
["**/*.ts", "!**/*.test.ts"]中,第一个 glob 匹配每个 .ts 文件。 第二个模式会修改第一个 glob,以从匹配中排除每个 .test.ts 文件。- 示例 2
传入的 URL 会通过斜杠
/拆分为多个部分。 相应地,**/node_modules/**会按如下方式拆分::双星号
**匹配node_modules段之前的任意路径。node_modules与 URL 中的node_modules匹配。双星号
**匹配后面的任何内容。
因此,模式
**/node_modules/**匹配包含node_modules的任意 URL。请记住,脚本的 URL 会与整个模式进行匹配。 如果移除第二个双星号
**,该模式将匹配以node_modules结尾的任意 URL,而这样的 URL 可能为零个。- 示例 3
跳过第二个双星号
**,以匹配以特定文件名结尾的任意模式。**/app.js匹配所有以app.js结尾的 URL。以下模式列表将忽略 node_modules 中的所有脚本,但名为 app.js 的脚本除外。
**/node_modules/** !**/app.js

