引言

在构建基于大语言模型（LLM）的应用时，模型输出的本质是自然语言文本。然而，下游系统（如 API 接口、数据库存储、前端界面渲染）通常需要结构化的数据输入，例如 JSON 对象、列表或符合特定模式（Schema）的字段。

LangChain 的输出解析器（Output Parsers）提供了一套标准化的机制，旨在将模型生成的文本自动转换为程序可直接消费的数据结构，从而在文本生成与业务逻辑之间建立稳固的桥梁。

纲要

• 输出解析器的定位与核心价值
  • 在 LangChain I/O 体系中的角色
  • 核心任务：从非结构化文本到结构化数据
• 常见输出解析器类型
  • StrOutputParser：纯文本输出
  • JsonOutputParser：JSON 对象输出
  • XMLOutputParser：XML 格式输出
  • CsvOutputParser：逗号分隔值输出
  • PydanticOutputParser：基于 Pydantic 模型的结构化输出
  • YamlOutputParser：YAML 格式输出
• 解析器与提示词的协作机制
• 模型对结构化输出的支持能力
• 实践示例：StrOutputParser 与 JsonOutputParser 的使用
• 最佳实践与注意事项

输出解析器在 LangChain 中的定位

LangChain 的经典 I/O 模型由三个核心组件构成：提示词模板（Prompt Template），负责将用户输入与预设模板结合以生成最终提示；大模型（LLM），负责处理提示并生成文本输出；输出解析器（Output Parser），负责将模型输出的文本转换为结构化数据。三者串联形成清晰的数据处理管道：

输出解析器的核心任务是将模型的自然语言输出转换为机器可理解的结构化数据。早期的实现方式通常依赖正则表达式从自由文本中提取信息，但由于模型输出的随机性，这种方式的匹配稳定性较差。随着模型能力的提升（如对原生 JSON 模式的支持），解析器可以与模型协同工作，在生成阶段即要求模型遵循特定的输出格式，从而显著提高数据转换的可靠性。

常见输出解析器概览

LangChain 提供了多种内置解析器，覆盖了主流的数据交换格式。以下是这些解析器的功能特性对比：

解析器	输出类型	是否支持流式	格式要求
StrOutputParser	字符串	是	无
JsonOutputParser	JSON 对象（dict）	是	需包含 {} 且符合 JSON 语法
XMLOutputParser	dict（解析后的 XML 结构）	是	需包含成对的 XML 标签
CsvOutputParser	List[str]	是	需为逗号分隔的值
PydanticOutputParser	Pydantic BaseModel 实例	否	需符合 Pydantic 模型字段定义
YamlOutputParser	Pydantic BaseModel 实例	否	需符合 YAML 语法规范

在使用上述解析器时，有两个关键点需要特别关注：

1. 格式指令注入：除 StrOutputParser 外，大多数解析器都提供了 get_format_instructions() 方法，用于生成指导模型按特定格式输出的说明文字。必须将该说明文字拼接到提示词中，否则模型无法知晓预期的输出结构。
2. 下游数据类型匹配：不同的解析器产出的数据类型各不相同（例如 JsonOutputParser 返回 dict，而 PydanticOutputParser 返回 BaseModel 实例）。下游处理逻辑必须与解析器的输出类型对应，否则将引发类型错误或属性访问异常。

模型结构化输出支持情况

并非所有模型都原生支持结构化输出或工具调用（Tool Calling）。LangChain 对常见模型的能力进行了标注，部分示例如下：

模型	支持结构化输出	支持工具调用	支持流式
OpenAI（gpt-4o, gpt-3.5-turbo）	是	是	是
DeepSeek（v3, r1）	是（非原生 JSON 模式）	部分版本支持	是
Anthropic Claude	是	是	是
社区模型（如 Ollama 本地模型）	取决于具体模型	取决于具体模型	取决于具体模型

在选定模型后，必须验证其能力与所选解析器的兼容性。例如，若模型不支持工具调用，强行使用 PydanticOutputParser 可能无法稳定地获得符合预期的结构化输出。

动手实践：StrOutputParser 与 JsonOutputParser

本节通过一个完整可运行的示例，演示 StrOutputParser 与 JsonOutputParser 的用法。示例使用 ChatOpenAI 作为模型（需自行配置 API Key），也可替换为其他兼容模型。

环境准备

安装必要的依赖包：

pip install langchain langchain-core langchain-openai

配置 API Key（以 OpenAI 为例）：

export OPENAI_API_KEY="你的OpenAI密钥"

代码示例

以下代码完整演示了两种解析器的使用方式：

from langchain_core.prompts import ChatPromptTemplate
from langchain_openai import ChatOpenAI
from langchain_core.output_parsers import StrOutputParser, JsonOutputParser

# 初始化模型
model = ChatOpenAI(model="gpt-3.5-turbo", temperature=0)

# ========== 1. StrOutputParser 示例 ==========
str_prompt = ChatPromptTemplate.from_template(
    "用一句话介绍{subject}。"
)
str_chain = str_prompt | model | StrOutputParser()
str_result = str_chain.invoke({"subject": "LangChain"})
print("字符串输出：", str_result)
print()

# ========== 2. JsonOutputParser 示例 ==========
# 实例化 JSON 解析器
json_parser = JsonOutputParser()
# 获取格式指令并注入到提示词中
format_instructions = json_parser.get_format_instructions()
json_prompt = ChatPromptTemplate.from_template(
    "请以 JSON 对象的形式返回以下信息，包含 name 和 age 两个字段。\n"
    "{format_instructions}\n"
    "用户输入：{input}"
)
json_chain = json_prompt | model | json_parser
json_result = json_chain.invoke({
    "input": "我叫小明，今年25岁。",
    "format_instructions": format_instructions
})
print("JSON 输出：", json_result)
print("类型：", type(json_result))
print("姓名：", json_result.get("name"))

执行结果示例

字符串输出： LangChain 是一个用于构建大语言模型应用的开源框架。

JSON 输出： {'name': '小明', 'age': 25}
类型： <class 'dict'>
姓名： 小明

通过 StrOutputParser 可以直接获得模型的原始文本输出（去除多余的空白或格式标记）；而 JsonOutputParser 则确保返回一个符合 JSON 规范的 Python dict 对象，可直接用于后续的业务逻辑处理。

最佳实践与注意事项

• 始终注入格式说明：除 StrOutputParser 外，其他解析器必须通过 get_format_instructions() 获取格式要求并拼接到提示词中。这是确保解析器正常工作的前提。
• 测试模型兼容性：在切换模型时，应首先使用简单的测试用例验证解析器是否能正常工作。特别是 PydanticOutputParser 等对模型结构化输出能力要求较高的解析器，更需要进行充分测试。
• 错误处理机制：当解析失败时（如 JSON 格式错误），LangChain 提供了 OutputFixingParser 等容错机制，可以尝试自动修复格式错误，后续文章将对此进行深入介绍。
• 与 LCEL 链式调用结合：解析器可以作为 LangChain Expression Language (LCEL) 管道的一部分，通过 | 符号与提示词模板、模型实例串联，构建清晰且可维护的数据处理流。

结语

输出解析器是连接大模型“非结构化输出”与“精确业务逻辑”之间的关键桥梁。通过合理选用字符串、JSON、Pydantic 等解析器，并配合提示词注入格式指令，可以让模型的回答变得可预测、可结构化，从而显著提升 LLM 应用的工程化水平。初学者可以从 StrOutputParser 和 JsonOutputParser 入手，逐步扩展到更复杂的自定义解析场景。

官方文档

• LangChain 官方文档（Output Parsers 章节）：https://python.langchain.com/docs/concepts/output_parsers/
• LangChain 核心包（langchain-core）API 参考：https://python.langchain.com/api_reference/core/output_parsers.html

总结

本文系统梳理了 LangChain 框架中输出解析器的核心概念、常见类型、与提示词的协作机制，以及模型兼容性等重要技术点。

通过 StrOutputParser 和 JsonOutputParser 的完整代码示例，展示了如何在实际项目中快速集成解析器，将模型输出转换为结构化数据，从而提升 LLM 应用的稳定性和可维护性。