【freemarker模板引擎语法】FreeMarker 是一个基于 Java 的模板引擎，常用于生成 HTML、XML、JSON 等文本格式。它通过将数据模型与模板结合，动态地生成最终的输出内容。以下是对 FreeMarker 模板引擎语法的总结，便于快速理解和使用。
一、基本语法结构
| 语法元素 | 说明 | 示例 |
| `${expression}` | 输出表达式的结果 | `${name}` |
| `@{expression}` | 用于处理转义字符 | `@{user.name}` |
| `<-- comment -->` | 注释语句 | `<-- 这是一个注释 -->` |
| ` | 条件判断 | ` |
| ` | 否则分支 | ` |
| ` | 否则如果条件 | ` |
`
| 遍历集合 | `
|
| ` | 定义变量 | ` |
| ` | 包含其他模板文件 | ` |
| ` | 定义宏 | ` |
| ` | 在宏中调用嵌套内容 | ` ${content} |
二、常用指令和功能
| 指令 | 说明 | 示例 |
| ` | 条件判断 | ` |
| ` | 否则 | ` |
`
| 遍历列表 | `
|
| ` | 跳出循环 | ` |
| ` | 继续下一次循环 | ` |
| ` | 定义函数 | ` |
| ` | 字符串转义 | ` |
| ` | 关闭转义 | ` |
| ` | 设置 FreeMarker 指令的起始 | ` |
三、表达式类型
| 表达式类型 | 说明 | 示例 |
| 变量 | 引用数据模型中的变量 | `${user.name}` |
| 方法调用 | 调用对象的方法 | `${user.getRole()}` |
| 字段访问 | 访问对象属性 | `${user.role}` |
| 算术运算 | 加减乘除等 | `${count + 1}` |
| 逻辑运算 | 与、或、非等 | `${isLogin && isAdmin}` |
| 比较运算 | 大于、小于、等于等 | `${age >= 18}` |
| 空值检查 | 判断是否为 null | `${user?exists}` |
四、常见错误与注意事项
| 问题 | 原因 | 解决方法 |
| 模板无法加载 | 文件路径错误或权限不足 | 检查路径和文件名是否正确 |
| 变量未定义 | 数据模型中缺少该变量 | 确保在代码中传递了正确的数据 |
| 语法错误 | 使用了不支持的语法 | 根据官方文档检查语法 |
| 编码问题 | 中文乱码 | 设置正确的编码（如 UTF-8） |
| 性能问题 | 大量嵌套或重复渲染 | 优化模板结构，减少冗余 |
五、总结
FreeMarker 是一个强大且灵活的模板引擎，适用于各种 Web 应用开发场景。掌握其基本语法和常用指令，能够显著提升开发效率和代码可维护性。在实际使用中，建议结合具体项目需求，合理设计模板结构，并注意避免常见的语法错误和性能问题。
通过表格形式的整理，可以更清晰地了解 FreeMarker 的核心语法和使用方式，帮助开发者快速上手并高效使用这一工具。