在构建网站时，我们常常会遇到这样的情况：页面的头部（Header）、底部（Footer）以及一些侧边栏、导航菜单等组件几乎在每个页面都会出现。如果每次都将这些公共部分的代码重复编写，不仅耗时耗力，而且一旦需要修改，就得逐个页面查找并更新，效率低下且容易出错。安企CMS（AnQiCMS）深知这一痛点，在模板引擎中提供了强大的模块化功能，其中include标签就是实现公共组件模块化显示的核心工具。
include标签的作用，顾名思义，就是将一个独立的模板文件（可以理解为一个代码片段或组件）嵌入到另一个模板文件中。通过这种方式，我们可以把网站中那些重复出现的结构，比如导航条、版权信息、侧边广告位等，各自保存为单独的模板文件。当页面需要这些组件时，只需简单地通过include标签引用，而无需复制代码，极大地提高了模板的可维护性和开发效率。
那么，具体该如何使用include标签呢？
首先，要合理组织模板文件。安企CMS建议将公共代码和代码片段存放在特定的目录中。通常，我们会在当前模板的根目录下创建一个名为partial的文件夹，将所有可复用的组件，如header.html、footer.html、sidebar.html等，统一放置其中。这样做的好处是结构清晰，便于管理。
引入公共组件的基本语法非常简洁：
{% include "partial/header.html" %}
这行代码会告诉安企CMS，在这里插入partial/header.html文件中定义的所有内容。当浏览器访问包含这行代码的页面时，就会把页头的内容渲染出来。
在使用include标签时，我们还需要考虑一些特殊情况。例如，如果你不确定某个公共组件文件是否存在，可以直接在include标签后加上if_exists修饰符：
{% include "partial/navigation.html" if_exists %}
这样，如果partial/navigation.html文件不存在，系统也不会报错，而是会默默地忽略掉这部分引用，避免因文件缺失而导致页面渲染失败。
更进一步，公共组件往往需要根据当前页面的上下文来显示不同的内容。例如，页头可能需要显示当前页面的标题，或者根据用户登录状态显示不同的导航项。这时候，include标签的with关键字就派上用场了。通过with关键字，我们可以向被include的模板传递特定的变量：
{% include "partial/header.html" with pageTitle="产品详情页" userName="张三" %}
在partial/header.html模板文件中，就可以直接使用{{pageTitle}}和{{userName}}来获取并显示这些传递过来的值了。
默认情况下，被include的模板会继承父模板的所有变量。但有时，为了避免变量冲突或者希望更严格地控制传递的变量范围，可以使用only关键字。当only与with同时使用时，被include的模板将只接收with中明确指定的变量，而不会继承父模板的其他变量：
{% include "partial/header.html" with pageTitle="新闻中心" only %}
这样，header.html中只能访问pageTitle，而不能访问父模板中可能存在的其他变量。
在实际的项目中，include标签的应用场景非常广泛。除了上面提到的页头、页脚、侧边栏外，它还可以用于：
- 导航菜单： 无论是顶部导航、底部导航还是多级下拉菜单，都可以将其独立成组件。
- 版权信息： 统一管理网站的版权声明、备案号等。
- 通用表单元素： 如搜索框、订阅邮件表单等。
- 面包屑导航： 作为动态生成路径的独立模块。
通过这种模块化的开发方式，网站的模板代码将变得更加整洁、结构清晰，大大降低了维护成本。当网站需要进行设计改版时，只需修改少数几个公共组件文件，就能实现全站更新，极大地提升了工作效率。同时，它也促进了团队成员之间的协作，每个人可以专注于各自负责的模块开发，最后再进行集成。
当然，在使用include标签时，也有一些小建议。首先，保持partial目录结构的有条理，避免组件文件杂乱无章。其次，合理命名变量，并注意传递变量时的类型和值。最后，虽然模块化很方便，但也要避免过度拆分，对于只出现一次或逻辑过于简单的代码片段，直接写在页面中可能更为高效。
常见问题 (FAQ)
1. include标签和extends标签有什么区别？
include标签用于将一个模板文件完整地插入到另一个模板的特定位置，它更侧重于代码片段的复用。你可以想象成把一个独立的小盒子（组件）放进一个大箱子（主页面）里。
而extends标签用于模板继承，它定义了一个基础骨架模板（父模板），其他模板（子模板）可以继承这个骨架，并重写父模板中定义的特定“区块”（block）。extends更侧重于页面结构的整体复用和定制。通常，一个页面模板会extends一个基础布局，然后include一些公共组件。
2. 如何在include进来的公共组件中获取当前页面的数据？
有两种主要方式。第一种是默认机制：被include的模板会继承父模板的所有上下文变量，所以大部分情况下，无需额外操作，公共组件就能访问当前页面的数据。例如，如果父页面定义了{{siteName}}，被include的页头模板可以直接使用它。
第二种是使用with关键字明确传递：当你想传递特定数据，或者想控制变量范围时，可以在include标签中使用with关键字，例如：{% include "partial/header.html" with currentPage="首页" %}。在header.html中，你就可以直接使用{{currentPage}}了。
3. 如果我在页头组件（partial/header.html）中定义了变量，这些变量会不会影响到其他页面内容？
通常不会。include标签引入的模板内部定义的变量，其作用域一般仅限于该被引入的模板自身。一旦该模板渲染完毕，这些内部变量的作用域也会随之结束，不会“泄露”到父模板或其他被include的模板中。但是，如果你在被include的模板中修改了从父模板继承的变量（例如{% set siteName = "新的站点名" %}），这种改变可能只对该include组件内部有效，具体行为取决于模板引擎的实现细节，稳妥的做法是避免在组件内随意修改继承的变量。