Skip to main content
每个LangChain和LangGraph的版本号遵循以下格式：MAJOR.MINOR.PATCH
  • 主要：需要代码更改的API更新。
  • 次要：保持向后兼容性的新功能和改进。
  • 补丁：错误修复和细微改进。

​
版本号

LangChain 和 LangGraph 遵循 语义化版本控制 原则：
  • 1.0.0: 首个稳定版本，包含可用于生产的API
  • 1.1.0: 以向后兼容的方式添加新功能
  • 1.0.1: 向后兼容的bug修复

​
API 稳定性

我们如下说明我们API的稳定性：

​
稳定的API

所有没有特殊前缀的API都被视为稳定，并已准备好投入生产使用。我们保持稳定功能的向后兼容性，仅在主要版本中引入破坏性更改。

​
测试版API

APIs 被标记为 beta 的功能已完善，但可能会根据用户反馈进行细微调整。它们适用于生产环境，但在未来的版本中可能需要微调。

​
Alpha API

APIs 被标记为 alpha 的为实验性，并可能发生重大变化。在生产环境中使用时请谨慎。

​
已废弃的API

APIs 被标记为 deprecated 的将在未来的主要版本中删除。当可能时，我们会指定删除的预期版本。为了处理弃用：
  1. 切换到推荐的替代API
  2. 遵循迁移指南（与主要版本一同发布）
  3. 当可用时，使用自动化迁移工具

​
内部API

某些API被明确标记为“内部”，方式有以下几种：
  • 一些文档提到了内部组件，并以此称呼它们。如果文档中提到某个组件是内部的，它可能会发生变化。
  • 以下划线开头（_）的函数、方法和其他对象。这是Python的标准约定，表示某个组件是私有的；如果任何方法以单个**_**开头，则表示这是一个内部API。
    • 例外情况：某些方法以_开头，但不含实现。这些方法旨在被提供实现的子类覆盖。这些方法通常是LangChain的公共API的一部分。

​
发布周期

主要版本（例如，1.0.0 → 2.0.0）可能包括：
  • API重大变更
  • 删除已弃用功能
  • 架构的重大改进
我们提供：
  • 详细的迁移指南
  • 尽可能提供自动迁移工具
  • 对上一主要版本的延长支持期
小版本更新（例如，1.0.0 → 1.1.0）包括：
  • 新功能与特性
  • 性能提升
  • 新增可选参数
  • 向后兼容的增强
补丁版本（例如，1.0.0 → 1.0.1）包括：
  • 错误修复
  • 安全更新
  • 文档改进
  • 无API更改的性能优化

​
版本支持策略

  • 最新主要版本：提供全面支持，处于积极开发状态（活跃状态）
  • 上一个主要版本：在下一个主要版本发布后12个月内提供安全更新和关键错误修复（维护状态）
  • 旧版本：仅提供社区支持

​
长期支持（LTS）版本

LangChain 和 LangGraph 1.0 均被指定为长期支持版本：
  • 版本 1.0 将保持活跃状态，直到版本 2.0 发布
  • 版本 2.0 发布后，版本 1.0 将进入维护模式，至少持续 1 年
  • 长期支持版本遵循语义版本控制（semver），允许在次要版本之间安全升级
  • 旧版本（LangChain 0.3 和 LangGraph 0.4）将保持维护模式，直至 2026 年 12 月
有关发布状态和支持时间线的详细信息，请参阅发布策略。

​
检查您的版本

检查您已安装的版本： 
import langchain_core
print(langchain_core.__version__)

​
升级

# Upgrade to the latest version
pip install -U langchain-core langchain

# Upgrade to a specific version
pip install langchain-core==1.0.0

​
预发布版本

我们偶尔会发布alpha和beta版本进行早期测试：
  • Alpha（例如，1.0.0a1）：早期预览，预期有重大更改
  • Beta（例如，1.0.0b1）：功能完整，可能存在小幅度更改
  • 发布候选版（例如，1.0.0rc1）：稳定发布前的最终测试

​
参见

在GitHub上编辑此页面的源代码。
通过MCP将这些文档编程连接到Claude、VSCode等，以获取实时答案。