运行/调试配置：Django 服务器

启用 Django 插件

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

按下 Ctrl+Alt+S 以打开设置，然后选择插件。
打开已安装选项卡，找到 Django 插件，并选中其名称旁的复选框。

创建：运行(U)｜编辑配置(E)｜ | Django 服务器

使用此对话框为 Django 服务器创建运行/调试配置。

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

项目	快捷方式	描述
	`Alt+Insert`	创建运行/调试配置。
	`Alt+Delete`	删除选定的运行/调试配置。请注意，您无法删除默认配置。
	`Ctrl+D`	创建所选运行/调试配置的副本。请注意，您将创建默认配置的副本。
		仅当您选择了临时配置时，才会显示该按钮。点击此按钮以将临时配置保存为永久配置。
		移入新文件夹／创建新文件夹。您可以通过将其放入文件夹对运行/调试配置进行分组。要创建文件夹，请在某个分类中选择配置，点击，并指定文件夹名称。如果仅选中了某个类别，则会创建一个空文件夹。随后，要将某个配置移入文件夹、在文件夹之间移动或移出文件夹，请使用拖动操作，或使用和按钮。要取消分组，请选择一个文件夹并点击。
		点击此按钮按字母顺序排序配置。

常用选项

项目	描述
名称(N)	为运行配置指定名称，便于在编辑或运行时快速识别。
存储为项目文件(S)	将包含运行配置设置的文件保存下来，以便与团队其他成员共享。默认位置是 .idea/runConfigurations 。但是，如果您不想共享 .idea 目录，可以将该配置保存到项目内的任何其他目录。默认情况下，该选项处于禁用状态，并且 PyCharm 会将运行配置设置存储在 .idea/workspace.xml 中。

项目

描述

名称(N)

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

存储为项目文件(S)

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

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

Django 服务器专用配置选项

项目

描述

Python 解释器

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

主持人

在此字段中，指定要使用的主机名。

端口

在此字段中，指定服务器启动的端口号。

其他选项

在此字段中，指定 django-admin.py 实用工具的选项。有关详细信息，请参阅 django-admin.py 和 manage.py   文档。

工作目录

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

通过键盘快捷键 Ctrl+Shift+F10 创建默认运行/调试配置，或在脚本的上下文菜单中选择运行时，工作目录为包含可执行脚本的目录。此目录可能不同于项目目录。
将此字段留空时，将使用 PyCharm 安装的 bin 目录。

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

将内容根添加到 PYTHONPATH

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

将源代码根添加到 PYTHONPATH

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

环境变量

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

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

要创建新变量，请点击，然后输入所需的名称和值。

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

                        Variable1 = Value1
                        Variable2 = Value2

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

".env" 文件路径

此字段显示带有环境变量的 .env 文件的路径。如果有多个文件，则以分号分隔其路径。

若要管理 .env 文件列表，请点击选择 ".env" 文件。在打开的环境文件对话框中，使用添加和移除以添加和移除文件。

您还可以使用和更改加载 .env 文件的顺序。

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
            
     

其他选项

点击修改选项，然后选择要添加到对话框中的选项。

操作系统

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

项目

描述

允许多个实例(U)

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

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

Django

项目	描述
运行浏览器	如果您希望在默认浏览器中打开 Django 应用，请选中此复选框。在下方文本字段中，输入打开应用的 IP 地址。
自定义运行命令	在此处指定您希望向 manage.py 实用工具注册的自定义命令。该命令正确添加到您的项目后，可以通过 Run manage.py task 命令在工具菜单中使用。有关详细信息，请参阅 Writing custom django-admin commands。
测试服务器	如果选中此复选框，将使用测试数据库启动 Django 开发服务器。如果未选中此复选框，将使用开发服务器。
不重新加载	如果选中此复选框， `runserver` 命令的 `-- noreload` 选项将启用。如果未选中此复选框，PyCharm 不会自动选择它，这意味着可以在自动重新加载模式下进行调试。有关详细信息，请参阅选项说明。仅在清除测试服务器复选框时，此字段可用。
调试时自动启动 JavaScript 调试器	启用此选项以自动启动 JavaScript 调试器。仅在 Google Chrome 及其他 Chromium-based browsers 中支持调试 JavaScript 代码。

Python

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

调试

项目	描述
仅调试我的代码	启用此选项时，调试器仅关注用户编写的代码，跳过外部库。

日志

以下选项与记录此配置的执行相关。有关更多信息，请参见设置日志选项。

项目	描述
指定要在控制台中显示的日志	指定在运行应用程序时显示哪些日志文件。点击添加新日志。在编辑日志文件别名对话框中，配置以下内容：别名(A) ：日志将显示的选项卡名称。日志文件位置(L) ：指定日志文件的路径或 Ant 模式。如果多个滚动日志文件匹配该模式，PyCharm 将显示最新的一个。显示可由模式覆盖的所有文件(S) ：显示所有匹配该模式的日志。对于表格中的日志，您可以配置以下选项：处于活动状态：显示指定的日志文件。跳过内容：不显示先前运行的旧日志消息。
将控制台输出保存到文件(S)	将控制台输出保存到指定位置。手动输入路径，或点击浏览按钮，然后在打开的对话框中指向所需位置。
在消息打印到stdout 时显示控制台	当应用程序写入标准输出流时激活控制台。
在消息打印到stderr 时显示控制台	当应用程序写入标准错误流时激活控制台。

启动前

项目	描述
添加启动前任务	选择此选项以添加以下可用任务之一：启动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+4` 或 `Alt+5` 自行为其打开相应的工具窗口。
启动时聚焦运行/调试工具窗口	选择此选项可在启动运行/调试配置时自动将焦点移至运行或调试工具窗口。
开始前显示运行/调试配置设置	选中此选项，在实际启动运行/调试配置之前显示其设置。

2026年 3月 24日