PyCharm 2025.2 Help

添加 Django 模板

启用 Django 插件

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

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

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

PyCharm 使您可以创建和渲染用支持的模板语言编写的模板:

需要注意的是,您可以在未实际安装模板语言的情况下编辑模板。 但是,为了创建或渲染模板,以及在视图和模板之间导航,必须正确安装相应的模板语言。

创建模板

为视图创建模板

假设您引用了一个尚不存在的 index.html 模板文件。

  1. index.html 被标记为未解析的引用:

    找不到模板

    Alt+Enter 或点击 意图灯泡 并选择创建缺失的模板:

    创建一个模板

    创建模板 对话框出现,显示只读模板名称(模板路径 字段)以及可能的模板位置列表(模板根目录 字段):

    创建 index.html 文件
  2. 选择模板目录,新模板将在此处创建。

    模板根目录 字段提供了新模板可能位置的列表。 此列表包括在 IDE 设置 Ctrl+Alt+S项目结构 页面中 指定 的模板目录,以及所有位于应用程序目录内的 templates 文件夹(如果有)。

  3. 点击 确定

    在指定位置创建了一个空的 .html 文件。

在使用某种模板语言之前,请在 IDE 设置 Ctrl+Alt+S模板语言 部分中配置它,并确保任何现有模板的文件类型都被正确识别。

为项目配置模板语言

  1. 打开 IDE 设置 Ctrl+Alt+S 并转到 语言与框架 | 模板语言

  2. 模板语言 列表中选择要在项目中使用的特定模板语言。

  3. 模板文件类型 区域中,指定将识别模板标签的文件类型。

    请注意,在 HTML、XHTML 和 XML 文件中,模板始终被识别。

    使用 添加移除 按钮来组成所需的文件类型列表。

要快速创建 Django 模板,您可以使用 实时模板。 实时模板允许您通过输入简短的缩写插入常见的 Django 模板标签。

使用实时模板插入模板标签

  1. 输入所需模板标签的缩写并按 Tab

    使用实时模板插入模板标签
  2. 如果实时模板包含 变量 ,光标将移动到第一个变量。

    输入变量的值,然后按 Tab 跳转到下一个变量。

    如果需要返回到上一个变量,请按 Shift+Tab

要查看 Django 模板文件中可用的实时模板列表,请转到 设置 | 编辑器 | 活动模板 并展开 Django 节点。

Django 实时模板

您可以编辑现有模板,或按照 创建实时模板 中的描述创建一个新模板。

配置目录

创建 Django 应用程序 时,您可以立即指定存储模板的文件夹。

定义模板目录

  1. 打开 IDE 设置 Ctrl+Alt+S ,展开 项目 节点,然后点击 项目结构 页面。

  2. 选择要标记为模板根目录的目录。

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

    • 点击 模板 ,位于 内容根 面板的工具栏上。

    • 在目录的上下文菜单中选择 模板

您还可以直接在 项目 工具窗口中将文件夹标记为模板目录:

将目录标记为模板文件夹

  1. 项目工具窗口 中,右键点击所需的目录。

  2. 从上下文菜单中选择 标记目录为 | 模板文件夹

    这会将标记的目录添加到 项目结构 页面中的模板目录列表中。

如果将某些文件夹标记为 资源 ,Django 可以跳过这些文件夹(禁用 Django 语言替换)。

调试 Django 模板

创建 Django 模板后,您可以使用 PyCharm 调试它们。

设置断点

  • 向模板文件添加一个断点。 为此,打开文件 templates/poll/index.html 并点击边距:

    断点

启动运行/调试配置

  • 通过点击 启动调试器 以调试模式启动所选的运行/调试配置。

    调试 Django 模板:启动调试配置

PyCharm 窗口出现。 您可以看到断点已命中, 调试 工具窗口在 线程与变量 选项卡中包含变量的当前值:

断点提示
最后修改日期: 2025年 9月 26日