FreeMarker生成XML需严格遵循XML语法并禁用HTML转义：1.模板开头用纯文本声明<?xml version="1.0" encoding="UTF-8"?>；2.通过!no_esc、<#noescape>或配置XMLOutputFormat.INSTANCE关闭自动转义。

FreeMarker 生成 XML 的核心原则是：**确保输出内容严格符合 XML 语法规范，同时避免 FreeMarker 默认的 HTML 转义干扰 XML 字符（如 ``, `&`）**。以下是关键要点和实用写法：

1. 声明 XML 版本和编码（推荐放在模板开头）

用纯文本方式输出 XML 声明，FreeMarker 不会解析它：

<?xml version="1.0" encoding="UTF-8"?>

2. 关闭自动转义，防止 `` 被转成 `<`, `>`

XML 内容中标签必须原样输出，不能被 HTML 转义。有三种常用方式：

OpenJDK 24

下载

• 在变量插值时加 !no_esc：<name>${user.name!no_esc}</name>
• 用 <#noescape>...</#noescape> 包裹一段区域：

<#noescape>
<user id="${user.id}">
<name>${user.name}</name>
<email>${user.email}</email>
</user>
</#noescape>

• 配置全局默认不转义 XML 模板（推荐）：在 Java 代码中设置模板的 outputFormat 为 XMLOutputFormat.INSTANCE，这样 `${...}` 默认就不转义（但需确保变量内容本身是合法 XML 字符，不含未转义的 `

3. 手动转义特殊字符（当变量含非法 XML 字符时）

如果变量可能含 ``, `&`, `"`, `'`，又不能依赖外部清理，可用内置函数转义：

• ${user.bio?xml} —— 对字符串做标准 XML 字符实体转义（`，`&` → & 等）
• 注意：?xml 只处理字符，不校验结构；它适合用于文本内容，**不能用于生成标签名或属性名**

4. 生成带命名空间、CDATA 或处理指令（可选进阶）

FreeMarker 本身不解析 XML 结构，所有 XML 构造都靠文本拼接，因此完全可控：

• 命名空间：<rss xmlns:dc="http://purl.org/dc/elements/1.1/" version="2.0">
• CDATA：<description><![CDATA[${item.desc?xml}]]></description>（注意：先 ?xml 转义内容，再包 CDATA 更安全）
• XML 处理指令（如 stylesheet）：<?xml-stylesheet type="text/xsl" href="feed.xsl"?>

不复杂但容易忽略的是：XML 对空白不敏感，但缩进和换行靠 FreeMarker 的 whitespace 控制（如 <#t> 或 <#lt>），建议用 <#compress> 避免意外空格破坏格式。