PyCharm 2026.1 Help

Django

启用 Django 插件

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

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

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

使用此页面为在同一窗口中打开的每个项目配置 Django 支持

“项目” 窗格

项目

描述

项目

此窗格显示在同一窗口中打开的项目列表。 列表中的第一个项目是 主项目

Django 支持窗格

项目

描述

启用 Django 支持

此复选框的默认状态取决于项目类型。 对于空项目,将禁用 Django 支持。 对于 Django 项目,默认启用;如有需要,您可以清除此复选框。 在这种情况下,其他字段将不可用。

Django 项目根目录

默认情况下,此字段显示包含所有项目文件的目录。 如有需要,您可以指定其他位置。

设置

点击浏览按钮以选择所需的设置文件。

使用以下任一方法:

  • 可以是位于 Django 项目根目录下、名称与 *settings*.py 匹配的任何文件。

  • 指向任意 Python 包,并将设置存储在 __init__.py 中。

    当您希望将设置拆分为多个模块并导入时,后一种方法很有用。

默认情况下,PyCharm 会显示 settings.py 文件,该文件位于您的 Django 项目的 Python 包目录中。

不使用 Django 测试运行器

默认情况下,此复选框未选中。 如果您希望使用在 集成工具 对话框中指定的任一替代测试运行程序,可以选中此复选框。

Manage.py 任务

管理脚本

在此为当前项目指定所需的 manage.py 文件。

默认情况下,PyCharm 会显示位于 Django 项目根目录下的 manage.py 文件。 点击 "浏览" 按钮 ,从文件系统中选择所需的 manage 文件。

环境变量

在此处指定要传递给脚本的环境变量。

用于跟踪文件的文件夹模式

在此指定以冒号分隔的文件夹名称。 如有需要,您可以使用 Glob 样式的通配符。 Django 仅拉取并将与此模式匹配的文件添加到 VCS。

2026年 3月 24日