跳到主要内容
每个 LangChain 和 LangGraph 版本号都遵循以下格式：MAJOR.MINOR.PATCH
  • 主要版本 (Major)：需要代码更改的破坏性 API 更新。
  • 次要版本 (Minor)：保持向后兼容性的新功能和改进。
  • 补丁版本 (Patch)：错误修复和次要改进。

​
版本号

LangChain 和 LangGraph 遵循 语义版本控制 原则
  • 1.0.0：第一个带有生产就绪 API 的稳定版本
  • 1.1.0：以向后兼容方式添加的新功能
  • 1.0.1：向后兼容的错误修复

​
API 稳定性

我们通过以下方式传达 API 的稳定性

​
稳定 API

所有没有特殊前缀的 API 都被认为是稳定的，并可用于生产。我们维护稳定功能的向后兼容性，并且只在主要版本中引入破坏性更改。

​
Beta API

标记为 beta 的 API 功能已完成，但可能会根据用户反馈进行微小更改。它们可以安全地用于生产，但可能需要在未来的版本中进行小的调整。

​
Alpha API

标记为 alpha 的 API 是实验性的，可能会发生重大更改。在生产环境中请谨慎使用这些 API。

​
已弃用 API

标记为 deprecated 的 API 将在未来的主要版本中移除。如果可能，我们会指定计划移除的版本。要处理弃用
  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 更改的性能优化

​
版本支持策略

  • 最新主要版本：提供完全支持并进行积极开发（ACTIVE 状态）
  • 上一个主要版本：在下一个主要版本发布后 12 个月内提供安全更新和关键错误修复（MAINTENANCE 状态）
  • 更旧的版本：仅提供社区支持

​
长期支持 (LTS) 版本

LangChain 和 LangGraph 1.0 都被指定为 LTS 版本
  • 版本 1.0 将保持 ACTIVE 状态，直到版本 2.0 发布
  • 版本 2.0 发布后，版本 1.0 将进入 MAINTENANCE 模式至少 1 年
  • LTS 版本遵循语义版本控制（semver），允许次要版本之间的安全升级
  • 旧版本（LangChain 0.3 和 LangGraph 0.4）将处于 MAINTENANCE 模式，直到 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 上编辑此页面源文件。
以编程方式连接这些文档到 Claude、VSCode 等，通过 MCP 获取实时答案。
© . This site is unofficial and not affiliated with LangChain, Inc.