LangChain 0.1 是框架的首个稳定版本，相比 0.1 发布前的早期版本，主要变动包括引入 LangChain 表达式语言（LCEL）、架构分层（如 langchain-core）以及接口标准化（如统一 invoke 方法）。

命令速用版

升级前请备份现有项目依赖，使用以下命令安装 0.1 系列核心包。

# 安装 LangChain 0.1 核心包及组件
pip install langchain==0.1.x langchain-core==0.1.x langchain-community==0.1.x
# 若使用 OpenAI 集成
pip install langchain-openai==0.1.x

为什么会这样

0.1 版本变更是为了解决早期版本“不可组合”与“依赖膨胀”的问题。

在 0.1 发布之前，框架功能集中在单一包中，导致依赖复杂且难以维护。0.1 版本通过分层架构（langchain-core 负责核心抽象，langchain-community 负责第三方集成）控制变更风险，并引入 LCEL 实现组件的可组合性，提升调试与观测体验。

分步处理

按以下步骤检查并迁移代码，确保接口调用符合 0.1 规范。

第一步：确认版本与包结构

检查当前安装的 langchain 版本，确认是否已包含 core 与 community 分包。0.1 版本确立了分层架构，核心抽象位于 langchain-core。

第二步：更新导入路径

将旧版导入语句调整为新版路径。例如，核心提示模板应从 langchain_core.prompts 导入，而非旧的 langchain.prompts。

# 旧版风格 (0.1 发布前)
from langchain.prompts import PromptTemplate
# 0.1 版本推荐风格
from langchain_core.prompts import PromptTemplate

第三步：迁移至 LCEL 语法

优先使用 LCEL 管道式语法替代传统 Chain 类。LCEL 支持流式输出与异步方法，是 0.1 版本的核心运行时。

# 传统 Chain 写法
chain = LLMChain(llm=llm, prompt=prompt)
# LCEL 写法 (0.1 推荐)
chain = prompt | llm

怎么验证是否生效

运行一个简单的 LLM 调用脚本，检查是否报错且能正常输出。

创建测试文件，使用新版导入路径实例化模型并调用 invoke 方法。若控制台无 ModuleNotFoundError 且返回预期文本，说明迁移成功。同时检查日志中是否有 LangSmith 相关追踪信息，确认可观察性集成生效。

常见坑

升级过程中容易遇到以下兼容性问题，需谨慎处理。

实验性模块移动：部分实验性功能（如 SQLDatabaseChain）在 0.1 版本后可能移至 langchain_experimental 包，需单独安装。

接口方法变更：模型调用方法从 __call__ 逐渐转向 invoke，旧代码直接调用实例可能报错。

依赖冲突：langchain-community 包含大量第三方集成，若未按需安装可能导致环境臃肿，建议仅安装需要的集成包。

常见问题

0.1 版本必须使用 LCEL 吗？

不是强制但强烈推荐。传统 Chain 类在 0.1 版本仍可用，但 LCEL 是官方推荐的可组合运行时，支持更好的流式与观测功能。

langchain-core 和 langchain 有什么区别？

langchain-core 包含核心抽象与接口（如 LCEL、Runnable），langchain 包含高阶用例（如特定 Chain、Agent）。0.1 版本后核心逻辑主要依赖 core 包。

升级后旧代码完全无法运行怎么办？

先回退版本至升级前状态，再按模块逐个迁移。优先修复导入错误，再调整接口调用方式，避免一次性全量修改。

参考来源

• AI 开源框架 LangChain 第一个稳定版，变化很大
• LangChain 从 0.1 到 1.0:架构演进、核心优化与完整迁移指南!
• 迭代一年，LangChain 首个稳定版本终于发布，LangGraph 把智能体构建为图
• LLM 之 LangChain(四)| 介绍 LangChain 0.1 在可观察性、可组合性、流媒体、工具、RAG 和代理方面的改进
• 轻装上阵，加速商业化，LangChain 0.1 预发布看点