运行/调试配置: Jest
创建: 
在此对话框中,创建用于运行 Jest 测试的配置。 有关为 JavaScript 和 TypeScript 代码创建 Vitest 测试的详细信息,请参阅 Vitest 官方网站上的 Vitest 功能。
在开始之前
请确保您的计算机上已安装 Node.js。
请确保在设置中启用了 JavaScript and TypeScript 插件。 按 Ctrl+Alt+S 打开设置,然后选择 。 点击 已安装 选项卡。 在搜索字段中,键入 JavaScript 和 TypeScript。 有关插件的更多信息,请参见 管理插件。
Jest 特定的配置设置
项目 | 描述 |
|---|
配置文件 | 在此字段中,指定要使用的 jest.config.js 或 jest.config.ts 文件:从列表中选择相应的文件,或点击 并在打开的对话框中选择该文件,或直接在该字段中输入路径。 如果该字段为空,PyCharm 将查找具有 jest 键的 package.json 文件。 搜索会在文件系统中从 工作目录 向上进行。 如果未找到合适的 package.json 文件,则会即时生成 Jest 默认配置。 |
Node 运行时 | 在该字段中,指定要使用的 Node.js 运行时。 如果您选择 项目 别名, PyCharm 将自动使用 JavaScript 运行时 页面中 Node 运行时 字段的项目默认解释器。 在大多数情况下, PyCharm 会检测项目默认运行时并自行填写该字段。 您还可以选择另一个已配置的本地或远程解释器,或点击 并配置一个新的解释器。 |
Node 参数 | 在此字段中,输入要传递给 Node.js 可执行文件的 Node.js 特定命令行选项。 可接受的选项为: 使用 --require coffeescript/register 可在运行期间即时将 CoffeeScript 文件编译为 JavaScript。 此模式要求 register.js 文件(其属于 coffeescript 包的一部分)位于您的项目中。 因此,请确保按照 安装 CoffeeScript 编译器 中的说明在本地安装 coffeescript 包。 使用 --inspect 或 --inspect-brk 参数以支持 Chrome 调试协议。 要在项目中使用 ECMAScript 模块 ,请在 Node 参数 字段中添加 —experimental-vm-modules 标志。
|
Jest 包 | 在此字段中,指定 jest、 react-scripts、 react-script-ts、 react-super-scripts 或 react-awesome-scripts 包的位置。 |
工作目录 | 在此字段中,指定应用程序的工作目录。 默认情况下, 工作目录 字段会显示项目根文件夹。 若要更改此预定义设置,请指定目标文件夹的路径。 |
Jest 选项 | 在此字段中,输入要传递给 Jest 的 Jest CLI 选项。 例如,添加 --watch 标志以启用 类似自动测试的运行器。 因此,在更改相关源代码时,当前运行配置中的任何测试都会自动重新启动,而无需点击 重新运行 按钮 。 |
环境变量 | 在此字段中,可选地指定用于执行命令的环境变量。 PyCharm 将在 process.env 的补全列表中显示这些变量。  |
测试 | 在此区域中,指定要执行的测试。 可用选项为: 所有测试: 选择此选项可运行来自 jest.config.js 或 jest.config.ts 配置文件,或来自生成的 Jest 默认配置 的所有测试。 在默认配置中,将通过 testRegex 属性 的默认值识别测试。 测试文件: 选择此选项可仅运行某个文件中的测试,并在 测试文件 字段中指定该文件的路径。 套件: 选择此选项可从某个测试文件中运行单个测试套件,并在 测试文件 字段中指定该文件的路径。 在 套件名称 字段中点击 ,并使用 和 按钮配置要运行的测试套件列表。 测试: 选择此选项可从某个测试文件中运行单个测试,并在 测试文件 字段中指定该文件的路径。 在 测试名称 字段中点击 ,并使用 和 按钮配置要运行的测试列表。
|
Docker 容器设置 | 此只读字段显示端口和卷绑定。 点击 以打开命令预览。  |
Docker Compose | 在此区域中,指定要传递给 Docker Compose 的命令和选项。 接受默认设置,或点击 并指定自定义设置,例如自定义 Docker Compose 标志,如 --rm 或 --service-ports。 详细了解请参阅 Docker 官方网站。 检查 命令预览。 |
通用设置
当您编辑运行配置(而不是运行配置模板)时,可以指定以下选项:
项目 | 描述 |
|---|
名称(N) | 为运行配置指定名称,便于在编辑或运行时快速识别。 |
存储为项目文件(S) | 将包含运行配置设置的文件保存下来,以便与团队其他成员共享。 默认位置是 .idea/runConfigurations 。 但是,如果您不想共享 .idea 目录,可以将该配置保存到项目内的任何其他目录。 默认情况下,该选项处于禁用状态,并且 PyCharm 会将运行配置设置存储在 .idea/workspace.xml 中。 |
运行/调试配置的树形视图包含一个工具栏,可帮助您管理 您的 项目 中可用的配置,并调整默认配置模板。
项目 | 快捷方式 | 描述 |
|---|

| Alt+Insert | 创建运行/调试配置。 |

| Alt+Delete | 删除选定的运行/调试配置。 请注意,您无法删除默认配置。 |

| Ctrl+D | 创建所选运行/调试配置的副本。 请注意,您将创建默认配置的副本。 |

| | 仅当您选择了 临时配置时,才会显示该按钮。 点击此按钮以将临时配置保存为永久配置。 |

| | 移入新文件夹/创建新文件夹。 您可以通过 将其放入文件夹对运行/调试配置进行分组。 要创建文件夹,请在某个分类中选择配置,点击 ,并指定文件夹名称。 如果仅选中了某个类别,则会创建一个空文件夹。 随后,要将某个配置移入文件夹、在文件夹之间移动或移出文件夹,请使用拖动操作,或使用 和 按钮。 要取消分组,请选择一个文件夹并点击 。 |

| | 点击此按钮按字母顺序排序配置。 |
启动前
在此区域中,您可以指定在启动所选运行/调试配置之前要执行的任务。 任务按照其在列表中的顺序执行。
项目 | 快捷方式 | 描述 |
|---|

| Alt+Insert | 点击该图标以添加以下可用任务之一: 启动Web 浏览器 :选择此选项可启动浏览器。 在打开的对话框中,选择浏览器类型,并提供启动 URL。 此外,指定是否使用 JavaScript 调试器启动浏览器。 运行外部工具 :选择此项以运行外部应用程序。 在打开的对话框中,选择您要运行的一个或多个应用。 如果它尚未在 PyCharm 中定义,请添加相应定义。 详细信息请参阅 外部工具 和 外部工具。 运行另一个配置 :选择执行另一个运行/调试配置,并在启动当前配置之前等待其结束。 如果您想并行运行多个配置,请使用 复合运行/调试配置。 运行File Watcher :选择此选项以让 PyCharm 应用所有当前活动的 文件监视器。 运行远程外部工具 :添加一个 远程 SSH 外部工具。 运行Grunt 任务: 选择此选项以运行 Grunt 任务。 在 Grunt 任务 对话框中,指定 Gruntfile.js ,其中定义了所需的任务,选择要执行的任务,并指定要传递给 Grunt 工具的参数。 指定 Node.js 运行时的位置、要传递给它的参数以及指向 grunt-cli 包的路径。 运行gulp 任务: 选择此选项以运行 Gulp 任务。 在 Gulp 任务 对话框中,指定 Gulpfile.js ,其中定义了所需的任务,选择要执行的任务,并指定要传递给 Gulp 工具的参数。 指定 Node.js 运行时的位置、要传递给它的参数以及指向 gulp 包的路径。 运行npm 脚本: 选择此选项以执行 npm 脚本。 在打开的 NPM 脚本 对话框中,指定 npm run/debug configuration settings。 编译TypeScript :选择运行内置的 TypeScript 编译器,从而确保您对 TypeScript 代码所做的所有更改反映在生成的 JavaScript 文件中。 在打开的 TypeScript 编译设置 对话框中,选择或清除 检查错误 复选框,以在检测到任何错误时配置编译器的行为: 断开数据源 :如果您希望在运行/调试配置之前断开与数据源的连接,请选择此选项。
|

| Alt+Delete | 点击该图标可从列表中移除所选任务。 |

| Enter | 点击该图标可编辑所选任务。 在打开的对话框中,进行必要的更改。 |


| Alt+Up Alt+Down | 点击这些图标以将所选任务在列表中上移一行或下移一行。 任务按照其在列表中的顺序执行。 |
显示此页面 | | 选中此复选框,以在实际启动运行/调试配置之前显示其设置。 |
激活工具窗口 | | 默认情况下,该复选框处于选中状态,并且当您启动运行/调试配置时,会打开 运行 或 调试 工具窗口。 否则,如果清除此复选框,将隐藏工具窗口。 但是,当配置正在运行时,您可以按 Alt+4 或 Alt+5 自行为其打开相应的工具窗口。 |
聚焦工具窗口 | | 选中此复选框可在启动运行/调试配置时,自动将焦点移动到 运行 或 调试 工具窗口。 |
2026年 3月 24日