作为一名资深的安企CMS网站运营人员，我深知一套清晰、高效的模板结构对于内容管理和网站维护的重要性。在安企CMS中，模板引擎提供了多种辅助标签来帮助我们更好地组织和重用模板代码，其中include、extends和macro是构建灵活模板架构的三大利器。它们各自承担着不同的职责，但共同服务于提升模板的可维护性和开发效率。
模块化内容复用：include标签
include标签的主要作用是在一个模板文件中嵌入另一个模板文件的内容。想象一下您的网站有一个通用的页眉（header）、页脚（footer）或侧边栏（aside），这些部分几乎在每个页面都会出现。如果每次都复制代码，不仅繁琐，而且一旦需要修改，就得逐一更改所有页面，耗时耗力且容易出错。
通过include标签，我们可以将这些公共模块抽离成独立的模板文件（例如partial/header.html），然后在需要显示它们的页面中简单地引入。默认情况下，被引入的模板会继承当前主模板的所有变量。如果需要为被引入的模板传递特定的数据，可以使用with参数；如果希望它只使用特定的变量而不继承主模板的全部上下文，则可以使用only参数进行限制。这种方式促进了代码的模块化，使得公共内容可以被高效复用，极大地简化了网站的日常维护和更新。当一个公共组件需要调整时，我们只需修改一个文件，所有引用它的页面都会同步更新。
定义页面骨架：extends标签
extends标签是构建模板继承体系的基石，它允许我们定义一个基础布局（或称“母版”），然后让其他模板基于这个基础布局进行扩展和填充。这就像是制作演示文稿时，先设计一个主幻灯片模板，所有其他幻灯片都继承其基本样式和布局，只需填充具体内容。
在安企CMS中，我们会创建一个像base.html这样的基础模板，其中包含网站的整体结构，比如<html>、<head>、<body>标签，以及页眉、页脚、主导航等固定区域。这些固定区域内部，我们使用block标签定义可被子模板重写或填充的区域（例如{% block title %}或{% block content %}）。子模板通过{% extends 'base.html' %}声明它继承自base.html，然后可以使用同名的block标签来覆盖或追加父模板中定义的相应内容。如果子模板没有重写某个block，则会保留父模板中的默认内容。
需要注意的是，extends标签必须是子模板中的第一个标签，这明确了模板的继承关系。extends的优势在于它强制性地统一了网站的整体布局和风格，确保了视觉一致性，同时也使得创建新页面变得异常简单，我们只需关注页面的独有内容，而无需重复编写整个页面结构。
封装动态组件：macro标签
macro标签则更侧重于定义可参数化的、可重用的代码片段或函数，它类似于编程语言中的函数。macro允许我们封装一段带有特定逻辑和参数的HTML结构，然后在模板的任何位置多次调用，每次调用时传入不同的参数来渲染出不同的内容。
例如，如果您的网站有一个文章列表，每篇文章的展示样式都相同，但内容（标题、链接、摘要等）不同，那么就可以将单篇文章的渲染逻辑封装成一个macro。定义macro时，我们会为其指定一个名称和一系列参数（例如{% macro archive_detail(archive) %}...{% endmacro %}）。在需要使用时，我们像调用函数一样传入数据对象（例如{{ archive_detail(item) }}）。与include不同的是，macro具有更严格的作用域，它只接受明确传入的参数，从而提供了更好的封装性和隔离性，减少了变量冲突的可能性。此外，macro还可以被保存到单独的文件中（例如archive.helper），然后通过import标签在其他模板中按需引入和使用。
综合运用与区分
理解了这三个标签各自的作用，我们就能更有效地组织安企CMS的模板结构：
extends用于构建网站的宏观布局，确定页面的整体骨架。include用于在固定布局中插入独立的、通用的内容片段，例如页头、页脚、侧边导航等，这些内容通常不怎么变化或变化较少。macro则用于创建动态的、可参数化的UI组件，例如文章卡片、产品列表项、表单输入框等，这些组件的展示逻辑固定，但展示的数据可变。
在实际开发中，它们常常协同工作。一个基础模板（extends）定义了页面布局，其中可能包含多个引入的公共部分（include），而页面内容区域则可能调用多个macro来渲染数据列表或复杂的组件。通过合理运用这三者，我们可以构建出清晰、高效、易于维护和扩展的安企CMS模板系统。
常见问题解答 (FAQ)
1. 我应该在什么时候选择使用include而不是macro？
选择include通常是为了复用那些内容相对固定、变化不大的HTML片段，例如网站的导航栏、页脚版权信息、或者一个不依赖于外部变量的纯静态广告位。include会继承父模板的整个上下文，如果片段需要少量来自父模板的变量，它也很方便。而macro则更适用于创建动态的、需要接受不同参数来渲染不同内容的组件，它提供了更严格的参数隔离，避免了全局变量污染，让组件的复用更加安全和可控。
2. extends标签的block与include标签有什么区别？
extends标签中的block是用来定义一个可被子模板填充或覆盖的区域，它关注的是页面整体布局的“洞口”或“占位符”。子模板通过重写这些block来注入自己的特定内容，从而形成完整的页面。而include标签则是一个直接将另一个模板文件的内容插入到当前位置的指令，它更像是“复制粘贴”一段代码。extends定义了模板的继承层次和结构，而include只是简单地插入内容片段，不涉及继承关系。
3. 我可以在一个macro中调用另一个macro或include一个文件吗？
是的，macro具有一定的灵活性。你可以在一个macro的定义内部调用另一个已经定义或导入的macro，这有助于构建更复杂的嵌套组件。同样，你也可以在macro中include其他模板文件，只要被include的文件不依赖于macro内部未显式传递的变量即可。但请记住macro的作用域特性，任何非通过参数传入的变量，在macro内部都是不可见的，除非它们是全局可访问的上下文变量。