在 LangChain 开发中，开发者经常面临一个基础选择：是使用PromptTemplate还是ChatPromptTemplate？这两个组件虽然都用于构建 Prompt，但它们服务于完全不同的模型范式。本文将从底层原理、应用场景和代码实现三个维度进行深度对比。
1. 核心差异概览
| 特性 | PromptTemplate | ChatPromptTemplate |
|---|---|---|
| 面向模型类型 | Text Model (Completion) 例：GPT-3 DaVinci, Llama 2 Base | Chat Model (Conversation) 例：GPT-4, Claude 3, Gemini |
| 底层数据结构 | 单一字符串 (String) | 消息列表 (List[BaseMessage]) |
| 思维模型 | “文本续写” (Next Token Prediction) | “角色扮演与对话” (Role-based Interaction) |
| 变量替换能力 | 仅支持字符串插值 (String Interpolation) | 支持字符串插值 +列表扩展 (List Expansion) |
| 最佳实践 | 用于简单任务、指令生成、老旧模型 | 用于对话系统、Agent、复杂指令遵循 |
2. 深度解析
2.1 PromptTemplate：文本世界的遗留者
PromptTemplate是大语言模型早期（2020-2022）的产物。当时的主流模型（如 GPT-3）接口接收的是纯文本。开发者需要手动设计文本格式（Prompt Engineering）。
工作原理：它本质上是一个 Python f-string 的高级封装。
fromlangchain_core.promptsimportPromptTemplate# 定义模板：本质上就是一段文本template=PromptTemplate.from_template("User: {input}\nAI:")# 渲染结果：一个长字符串formatted=template.format(input="Hello")# 输出: "User: Hello\nAI:"2.2 ChatPromptTemplate：结构化交互的未来
ChatPromptTemplate是为了适应 ChatGPT 及其后续模型（RLHF 训练的对话模型）而设计的。这些模型在训练时就区分了 System（系统指令）、User（用户）和 Assistant（AI）的角色。
工作原理：它构建的是一个由BaseMessage对象组成的列表。
fromlangchain_core.promptsimportChatPromptTemplate# 定义模板：由角色和内容组成的列表template=ChatPromptTemplate.from_messages([("system","You are a helpful assistant."),("human","{input}")])# 渲染结果：一个消息对象列表formatted=template.format_messages(input="Hello")# 输出: [SystemMessage(content="..."), HumanMessage(content="Hello")]3. 常见疑问：为什么不直接用string.format(f-string)？
用户提问：PromptTemplate可以用string.format()代替吗？
回答：在简单场景下可以，但在工程化场景下不推荐。
如果你只是写一个简单的脚本，f"Hello {name}"确实比PromptTemplate.from_template("Hello {name}")更简洁。但在复杂的 LangChain 应用中，PromptTemplate提供了 Python 原生字符串无法比拟的优势：
部分填充 (Partial Formatting)：
你可以先填充一部分变量（例如由另一个 Chain 生成的变量），保留另一部分变量留给后续步骤填充。这是构建复杂 Chain 的基础。template=PromptTemplate(template="{foo} {bar}",input_variables=["foo","bar"])partial=template.partial(foo="Hello")# partial 现在是一个只等待 "bar" 的新模板print(partial.format(bar="World"))# -> "Hello World"输入验证 (Validation)：
LangChain 会自动检查变量名是否匹配，防止因为拼写错误导致的运行时 Bug。序列化与加载 (Serialization)：
PromptTemplate可以被保存为 JSON/YAML 文件并重新加载，这对于 Prompt 的版本管理和从外部配置加载 Prompt 至关重要。与其他组件集成：
它实现了Runnable接口，可以直接接入 LCEL 管道 (chain = prompt | model)，而原生字符串不能直接作为 Runnable 使用。
4. 总结
随着 LLM 产业向 Chat Model 全面转移，ChatPromptTemplate已经成为事实上的标准。除非有极其特殊的理由使用 Text Completion 模型，否则应始终优先选择ChatPromptTemplate，以获得更好的结构化支持和安全性。
