PyCharm 2025.2 Help

Django 结构工具窗口

启用 Django 插件

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

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

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

Django 结构 工具窗口提供了一种快速创建、重构和导航 Django 项目主要组件的方法。

查看项目结构

  • 点击左侧的 Django 结构 打开工具窗口。

    Django 结构工具窗口已打开

    如果未显示工具窗口图标,请点击 更多工具窗口 并从列表中选择 Django 结构

  • Django 结构 工具窗口列出了以下组件:

    • 模型

    • 管理员类

    • 视图

    默认情况下,所有组件都是可见的。 要隐藏组件,请点击工具栏中的 查看选项 并在 显示 部分取消选中它。

  • 默认情况下,组件按组件类型分组。 要按应用分组,请点击工具栏中的 查看选项 并选择 应用

    Django 结构按应用分组
  • 要跳转到某个组件,请双击它。 包含的文件将在编辑器中打开,并将光标定位到相应的类声明或函数定义。

    从 Django 结构工具窗口跳转到 Django 组件

访问项目设置

  • Django 结构 工具窗口中,双击 设置设置。 Django 项目的设置文件(例如, settings.py )将在编辑器中打开。

管理应用

您可以使用 Django 结构 工具窗口创建新应用并运行迁移。

创建应用

  1. 请执行以下操作之一:

    • 单击 新建 Django 应用 ,在 Django 结构 工具窗口的工具栏中。

      在 Django 结构工具窗口中创建 Django 应用
    • 右键点击现有应用。 如果尚无应用,请点击 创建应用 链接。

      从上下文菜单中选择 新建 Django 应用

  2. 在打开的终端中指定应用名称并按 Enter

    在 manage.py 控制台中指定应用名称

为应用运行迁移

  1. Django 结构 工具窗口中右键点击应用并从上下文菜单中选择 创建迁移

    为应用创建迁移
  2. 应用名称会自动插入到打开的终端中。 按 Enter

    为应用创建迁移
  3. 返回 Django 结构 工具窗口,右键单击应用,并从上下文菜单中选择 迁移

  4. 应用名称会自动插入到打开的终端中。 请按 Enter

  • Django 结构 工具窗口中右键点击应用并从上下文菜单中选择 在项目视图中打开

  • 应用目录将在 项目 工具窗口中打开。

    在项目工具窗口中打开应用目录

管理模型

Django 结构 工具窗口允许您对模型执行以下操作:

创建模型

  1. Django 结构 工具窗口中,右键点击 模型 节点或任何现有模型。

  2. 从上下文菜单中选择 新建模型

    在 Django 结构工具窗口中创建新模型
  3. 如果应用包含多个模型文件,例如一个目录或一个包含模型的 Python 模块,PyCharm 将要求您选择新模型的文件。

    选择新模型的位置
  4. 包含模型的文件(例如, models.py )将在编辑器中打开。

    指定新模型的名称并按 Enter ,然后您可以继续添加字段和其他模型代码以替代 pass

    新模型已在包含模型的文件中创建

在管理界面中注册模型

  1. Django 结构 工具窗口中右键点击模型并从上下文菜单中选择 在 Django 管理员中注册

    在管理界面中注册模型
  2. admin.py 在编辑器中打开,并添加了带有 @admin.register 装饰器的新模型管理类。

    模型已在 admin.py 中注册

    Enter 确认类的创建。

当模型在管理界面中注册后,相应的模型管理类会列在 管理添加 节点下的 Django 结构 工具窗口中。

如果您的项目包含尚未用于注册模型的模型管理类,它们会在 Django 结构 工具窗口中显示为灰色。

未使用的管理类

您可以使用上下文菜单将模型注册到这样的模型管理类。

使用未使用的管理类注册模型

  1. Django 结构 工具窗口中右键点击模型管理类并选择 在 Django 管理员中注册

    使用未使用的模型管理类注册模型
  2. 在弹出窗口中选择模型。 如果没有未注册的模型,将会出现 所有模型已注册 消息。

    选择一个模型与管理类一起注册
  3. admin.py 在编辑器中打开,并向模型管理类添加了 @admin.register 装饰器。

您还可以使用 管理添加 节点中模型管理类的上下文菜单查找模型管理类的用法、重构它们以及导航到相应的模型。

  1. Django 结构 工具窗口中右键点击模型管理类并选择 转到模型

    从模型管理类导航到模型
  2. 如果所选管理类注册了多个模型,您需要在弹出窗口中选择模型。

    选择一个模型从管理类导航

重构模型

  1. Django 结构 工具窗口中右键点击模型。

  2. 在打开的上下文菜单中选择 重构 并从列表中选择重构。

    在 Django 结构工具窗口中重构模型

查找模型的用法

  • Django 结构 工具窗口中右键点击模型并从上下文菜单中选择 查找用法

    在 Django 结构工具窗口中查找模型的用法

    查找工具窗口打开,并显示搜索结果。 有关信息,请参阅 在项目中查找用法

管理视图

Django 结构 工具窗口允许您对视图执行以下操作:

创建视图

  1. Django 结构 工具窗口中,右键点击 视图 节点或任何现有视图。

  2. 从上下文菜单中选择 新建视图

  3. 选择视图类型。

    选择视图类型
  4. 如果应用包含多个视图文件,PyCharm 将要求您选择新视图的文件。

  5. 包含视图的文件(例如, views.py )将在编辑器中打开。

    指定新视图的名称并按 Enter ,然后您可以继续添加视图代码。

    新视图已在包含视图的文件中创建

重构视图

  1. Django 结构 工具窗口中右键点击视图。

  2. 在打开的上下文菜单中选择 重构 并从列表中选择重构。

    在 Django 结构工具窗口中重构视图

查找视图的用法

  • Django 结构 工具窗口中右键点击视图,并从上下文菜单中选择 查找用法

    在 Django 结构工具窗口中查找模型的用法

    查找工具窗口打开,并显示搜索结果。 有关信息,请参阅 在项目中查找用法

最后修改日期: 2025年 9月 26日