GPT4All 聊天模板（Chat Template）详解：Jinja 模板、系统消息与完整故障排查指南

本文基于 GPT4All 官方文档 gpt4all-bindings/python/docs/gpt4all_desktop/chat_templates.md 并结合 gpt4all-chat、gpt4all-backend 的源码实现，系统讲解聊天模板与系统消息的原理、v3.5 版本的重大变更、各类报错的排查方法，以及如何查找、编写（包括 GPT4All v1 专属语法）聊天模板。读完后，你将能够为任意侧载（sideload）的 GGUF 模型配置正确的输入格式，并理解 GPT4All 将对话渲染为模型输入文本的完整底层链路。

什么是聊天模板？

大语言模型原生只会做一件事：补全纯文本。模型本身并不知道自己输出的内容与用户输入之间的边界，也不天然理解"谁在说话"。为了支持多轮对话，LLM 通过**聊天模板（chat template）**将整段对话转换为特定的纯文本格式——例如为每条消息加上角色标记、分隔符或控制 token。

关键在于：每个模型都必须使用与其训练格式匹配的模板。某个模型是针对特定格式设计并调优的，使用错误的模板会显著降低输出质量，甚至导致模型不遵循指令。GPT4All 随内置模型列表提供了配套模板，绝大多数场景下直接沿用即可。

需要修改聊天模板的典型原因只有两个：

1. 你侧载了一个模型，但该模型没有附带聊天模板；
2. 你希望对送入 LLM 的输入做比"系统消息"更细粒度的控制。

什么是系统消息？

系统消息（system message）是一条以特殊方式控制 LLM 响应、并影响整段对话的消息。它可以很短，例如 "Speak like a pirate."（像个海盗一样说话），也可以很长，包含大量需要模型在整个对话中持续记住的上下文。

需要注意的是，并非所有模型都设计为使用系统消息——有些模型在训练时从未见过 system 角色，此时系统消息的效果会打折扣甚至适得其反。这也是选择"系统消息"还是"修改模板"时需要考虑的因素。

如何自定义聊天模板或系统消息？

操作路径为 Settings（设置）> Model（模型），具体步骤：

1. 在设置页顶部确认选中的是你要修改的那个模型（模型下拉框选错对象是常见的配置失误）；
2. 修改"Prompt Template"（聊天模板）与"System Prompt"（系统消息）字段；
3. 善用模型克隆：克隆一个模型后，克隆体可以使用与基础模型不同的聊天模板或系统消息，从而实现"每个对话使用不同配置"的效果；
4. 这些设置立即生效。修改之后，在聊天视图点击 "Redo last response"（重做上一条回复），新回复就会按新配置生成，无需重开对话。

从源码结构看，这套即时生效的机制有明确的实现支撑：聊天视图 ChatView.qml 中通过 Connections 监听 MySettings 的 onChatTemplateChanged 与 onSystemMessageChanged 信号，只要当前模型的模板或系统消息发生变化，就会立即重新执行输入框上方的错误检查逻辑。

你需要自己写一个聊天模板吗？

通常不需要。唯一的例外是：模型不在官方模型列表中、且文件本身不内置聊天模板。这类模型在 Model Settings 页面的聊天模板输入框上方会显示 "Clear"（清空） 按钮，而不是官方模型显示的 "Reset"（重置） 按钮——这是一个很好的识别信号：

• 显示 Reset：说明有随模型内置或随官方列表下发的默认模板，可以一键恢复；
• 显示 Clear：说明模板来自用户自行填写，清空后需要按照本文后面的步骤去查找或创建模板。

GPT4All v3.5 有哪些重大变化？

GPT4All v3.5 对聊天模板系统做了彻底重构，有三个关键差异：

1. 模板作用于整段对话：聊天模板现在格式化的是整个会话（the entire conversation），而不再只是单条消息对（single pair of messages）；
2. 改用 Jinja 语法：模板使用标准 Jinja 模板语言，取代了旧版自创的 %1 / %2 占位符语法；
3. 系统消息必须是纯文本：系统消息中不应再包含任何控制 token 或末尾空白。

升级注意：如果你在升级到 v3.5 之前添加或修改过聊天模板或系统消息，这些旧配置将不再可用，需要按本文后续的故障排查章节迁移。

常见错误与警告排查

以下各节按 GPT4All 中实际会出现的报错/警告文案组织，均可在 ChatView.qml 的 checkError() 函数中找到对应的触发条件。

错误/警告：System message is not plain text（系统消息不是纯文本）

这个问题很好修复。打开模型设置，检查系统提示词，寻找三类内容：

• 控制 token，例如 `