PyCharm 2025.3 Help

Django 支持

启用 Django 插件

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

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

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

先决条件

请确保已在您的计算机上正确安装 Django 框架 和相应的 Python 解释器。

支持的 Django 和 Python 版本

PyCharm 支持最新的 Django 版本。 相应的 Python 版本取决于 Django。 请参阅 我可以在 Django 中使用哪个 Python 版本?

Django 支持

PyCharm 中的 Django 支持包括:

启用或禁用 Django 支持

可在 Django 页面 中通过选中/取消选中复选框 启用 Django 支持 来启用或禁用 Python 项目的 Django 支持。

要启用 Django 支持,请执行以下步骤:

  1. 打开项目 设置 对话框(Ctrl+Alt+S ),然后转到 Python | Django 页面。

  2. 请确保已选中复选框 启用 Django 支持 。您还可以使用下方字段配置所需设置:

    描述

    启用 Django 支持

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

    Django 项目根目录

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

    Django 项目根目录字段

    设置

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

    使用以下任一方法:

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

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

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

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

    不使用 Django 测试运行器

    默认情况下,此复选框未选中。 如果您希望使用在 PyCharm 集成工具 对话框中指定的任一替代测试运行器(文件 | 设置 | Python | 集成工具 适用于 Windows 和 Linux, PyCharm | 设置 | Python | 集成工具 适用于 macOS),可以选中它。

    Manage.py 任务

    管理脚本

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

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

    环境变量

    在此指定要传递给脚本的环境变量。 点击 打开 环境变量 窗口。 按 添加新变量,并在相应字段中输入其 名称

    环境变量字段

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

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

    用于跟踪文件的文件夹模式字段
  3. 应用更改(如果有),然后关闭对话框。

最后修改日期: 2025年 12月 2日