PyCharm 2026.1 Help

运行/调试配置:Django 测试版块配置

启用 Django 插件

此功能依赖 Django 插件,该插件在 PyCharm 中已捆绑并默认启用。 如果相关功能不可用,请确保没有禁用该插件。

  1. 按下 Ctrl+Alt+S 以打开设置,然后选择 插件

  2. 打开 已安装 选项卡,找到 Django 插件,并选中其名称旁的复选框。

创建: 运行(U)| 编辑配置(E)| 添加新配置| Django 测试

使用此对话框创建 运行/调试配置 ,用于 Django 测试

工具栏

运行/调试配置的树形视图包含一个工具栏,可帮助您管理 您的 项目 中可用的配置,并调整默认配置模板。

项目

快捷方式

描述

添加按钮

Alt+Insert

创建运行/调试配置。

“移除”按钮

Alt+Delete

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

复制

Ctrl+D

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

保存配置

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

移入新文件夹/创建新文件夹

移入新文件夹/创建新文件夹。 您可以通过 将其放入文件夹对运行/调试配置进行分组。

要创建文件夹,请在某个分类中选择配置,点击 文件夹 ,并指定文件夹名称。 如果仅选中了某个类别,则会创建一个空文件夹。

随后,要将某个配置移入文件夹、在文件夹之间移动或移出文件夹,请使用拖动操作,或使用 上移下移 按钮。

要取消分组,请选择一个文件夹并点击 删除配置

对配置排序

点击此按钮按字母顺序排序配置。

常用选项

项目

描述

名称(N)

为运行配置指定名称,便于在编辑或运行时快速识别。

允许多个实例(U)

允许并行运行此运行配置的多个实例。

默认情况下,该选项处于禁用状态。当您在另一个实例仍在运行时启动此配置,PyCharm 会建议先停止正在运行的实例,再启动另一个实例。 当某个运行配置占用大量资源且没有充分理由运行多个实例时,这将很有帮助。

存储为项目文件(S)

将包含运行配置设置的文件保存下来,以便与团队其他成员共享。 默认位置是 .idea/runConfigurations 。 但是,如果您不想共享 .idea 目录,可以将该配置保存到项目内的任何其他目录。

默认情况下,该选项处于禁用状态,并且 PyCharm 会将运行配置设置存储在 .idea/workspace.xml 中。

Django 测试专用选项

项目

描述

目标

指定要执行的目标。 如果该字段留空,则表示将执行 INSTALLED_APPS 中指定的所有应用中的所有测试。

  • 如需在某个应用中运行测试,请指定该应用的名称。

  • 要运行特定测试用例,请在应用名称后指定其名称,并用点分隔。

  • 要运行测试用例中的单个测试方法,请在点号后添加测试方法名称。

对于测试目标中包含的 doctest ,同样适用这些规则。 测试标签用作要执行的测试方法或类的路径。 如果存在带有 doctest 的函数,或带有类级 doctest 的类,您可以通过将测试方法或类的名称追加到标签后,来调用该测试。

自定义设置

如果选中此复选框,Django 测试将使用指定的自定义设置运行,而非默认设置。

指定包含 Django 设置的文件的完全限定名称。 您可以在右侧的文本字段中手动输入,或点击浏览按钮,并在 打开的对话框 中选择一个。

如果未选中此复选框,Django 测试将使用默认设置运行,该设置在 Django 页面 的 设置 字段中定义。 文本字段已禁用。

选项

如果选中此复选框,您可以指定传递给 Django 测试的参数。 在右侧的文本字段中输入参数列表,在参数前加上 --,并使用空格作为分隔符。 例如:

--noinput --failfast

如果未选中此复选框,文本字段将被禁用。

环境变量

此字段显示环境变量列表。 如果列表包含多个变量,则它们用分号分隔。

默认情况下,此字段包含变量 PYTHONUNBUFFERED ,且其值设为 1。 要填写列表,请点击“浏览”按钮,或按 Shift+Enter ,并在 环境变量 对话框中指定所需的环境变量集。

要创建新变量,请点击 添加按钮 ,然后输入所需的名称和值。

您可能希望使用存储在文本文件中的一系列记录来填充该列表,例如:

Variable1 = Value1 Variable2 = Value2

只需从文本文件复制变量列表,然后在 环境变量 对话框中点击 粘贴粘贴)。 变量将被添加到表中。 点击 确定 以完成此任务。 在任何时候,您都可以在 环境变量 对话框中选择所有变量,点击 复制 复制 ,并将它们粘贴到文本文件中。

Python 解释器

从列表中选择预配置的 Python 解释器之一。

解释器选项

在此字段中,指定要传递给解释器的 命令行选项。 如有必要,点击 展开该字段 ,并在编辑器中键入字符串。

工作目录

指定正在运行的任务要使用的目录。

  • 通过键盘快捷键 Ctrl+Shift+F10 创建默认运行/调试配置,或在脚本的上下文菜单中选择 运行 时,工作目录为包含可执行脚本的目录。 此目录可能不同于项目目录。

  • 将此字段留空时,将使用 PyCharm 安装的 bin 目录。

您可以在此字段中使用 路径变量

将内容根添加到 PYTHONPATH

选中此复选框可将项目的所有 内容根添加到环境变量 PYTHONPATH。

将源代码根添加到 PYTHONPATH

选中此复选框可将项目的所有 源代码根添加到环境变量 PYTHONPATH。

Docker 容器设置

点击 "浏览" 按钮 打开对话框,并指定以下设置:

选项

  • 发布所有端口 :将所有容器端口公开给主机。 对应于 --publish-all 选项。

  • 端口绑定 :指定 端口绑定列表。 类似于与 docker run 一起使用 -p 选项。

  • 卷绑定 :在此字段中指定特殊文件夹( )与运行 Docker 守护进程的计算机上的文件夹之间的绑定。 这对应于 -v 选项。 有关详细信息,请参阅 管理容器中的数据

  • 环境变量 :在此字段中指定环境变量及其值的列表。 这对应于选项 -e。 有关详细信息,请参阅 ENV(环境变量)

  • 运行选项 :在此字段中指定 Docker 命令行选项

点击 展开表格。 点击 来构建列表。

Docker Compose

命令和选项

您可以使用 Docker Compose 命令行界面的以下命令:

命令

支持的选项

up :为某个服务构建、创建、启动并附加到容器。

  • --abort-on-container-exit

  • --build

  • --exit-code-from SERVICE

  • --scale SERVICE=NUM...

  • --timeout TIMEOUT

run :针对某个服务运行一次性命令。

  • --entrypoint CMD

  • -l, --label KEY=VAL

  • --name NAME

  • -p, --publish=[]

  • --rm

  • --service-ports

  • --use-aliases

  • -u, --user=""

  • -v, --volume=[]

exec :在服务中运行任意命令。

  • --index=index

  • --privileged

  • -u, --user USER

命令预览

使用此字段预览完整命令字符串。

例如,在 命令和选项 字段中使用 up --build exec --user jetbrains 组合将在预览中生成以下输出:

docker compose -f C:\PyCharm-2019.2\Demos\djangodocker-master\docker-compose.yml <override configuration file> up --build exec --user jetbrains

日志

使用这些设置指定在运行或调试期间生成的哪些日志文件应显示在控制台中,即显示在 运行调试工具窗口 的专用选项卡上。

有关如何启用 日志 字段的信息,请参阅 设置日志选项

项目

描述

是否处于活动状态

在此列中选中复选框,可在 运行工具窗口调试工具窗口 的相应选项卡中显示日志条目。

日志文件条目

此列中的只读字段列出要显示的日志文件。 列表可包含:

  • 特定文件的完整路径。

  • 用于替换完整路径或模式的别名。 这些别名也会显示在显示相应日志文件的选项卡页眉中。

    如果日志条目模式定义了多个文件,选项卡页眉将显示文件名,而不是日志条目别名。

跳过内容

选中此复选框以跳过所选日志的先前内容。

保存控制台输出到文件

选中此复选框以将控制台输出保存到指定位置。 手动输入路径,或点击浏览按钮,并在 打开的对话框 中指向所需位置。

当向标准输出流打印消息时显示控制台

选中此复选框可在关联进程写入标准输出流时激活输出控制台并将其置于前台。

在向标准错误流打印消息时显示控制台

选中此复选框可在关联进程写入标准错误流时激活输出控制台并将其置于前台。

添加按钮

点击此按钮以打开 编辑日志文件别名对话框 ,在其中您可以选择新的日志条目并为其指定别名。

Edit 按钮

点击此按钮,在 编辑日志文件别名对话框 中编辑所选日志文件条目的属性。

“删除”按钮

点击此按钮以从列表中移除所选日志条目。

"浏览" 按钮

点击此按钮可编辑所选日志文件条目。 仅在选中条目时才可使用该按钮。

启动前

在此区域中,您可以指定在启动所选运行/调试配置之前要执行的任务。 任务按照其在列表中的顺序执行。

项目

快捷方式

描述

添加按钮

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+4Alt+5 自行为其打开相应的工具窗口。

聚焦工具窗口

选中此复选框可在启动运行/调试配置时,自动将焦点移动到 运行调试 工具窗口。

2026年 3月 24日