OSS 版本号遵循 Semantic Versioning 定义的 MAJOR.MINOR.PATCH 格式。
  • Major：需要修改代码的破坏性 API 更新。
  • Minor：保持向后兼容的新功能和改进。
  • Patch：Bug 修复和小幅改进。
例如：
  • 1.0.0：第一个稳定版本，包含可用于生产环境的 API
  • 1.1.0：以向后兼容方式添加的新功能
  • 1.0.1：向后兼容的 bug 修复

​
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）包括：
  • Bug 修复
  • 安全更新
  • 文档改进
  • 不涉及 API 变更的性能优化

​
版本支持策略

  • 最新主版本：提供完整支持和活跃开发（ACTIVE 状态）
  • 上一个主版本：在下一个主版本发布后的 12 个月内提供安全更新和关键 bug 修复（MAINTENANCE 状态）
  • 更早版本：仅提供社区支持

​
长期支持 (LTS) 版本

LangChain 和 LangGraph 1.0 都被指定为 LTS 版本：
  • 版本 1.0 会在版本 2.0 发布前保持 ACTIVE 状态
  • 版本 2.0 发布后，版本 1.0 会进入 MAINTENANCE 模式至少 1 年
  • LTS 版本遵循语义化版本控制 (semver)，允许在次要版本之间安全升级
  • 旧版本（LangChain 0.3 和 LangGraph 0.4）处于 MAINTENANCE 模式，直到 2026 年 12 月

​
1.0 之前的包

Deep Agents (deepagents) 是一个处于活跃开发中的 1.0 之前的包。作为快速演进的包，API 可能在次要版本之间变更，但 Deep Agents 会尽可能减少破坏性变更。达到版本 1.0 后，Deep Agents 会采用与 LangChain 和 LangGraph 相同的 LTS 策略。 有关发布状态和支持时间线的详细信息，请参阅发布策略。

​
检查版本

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

​
升级

# 升级到最新版本
pip install -U langchain-core langchain

# 升级到特定版本
pip install langchain-core==1.0.0

​
预发布版本

有时会发布 alpha 和 beta 版本用于早期测试：
  • Alpha（例如 1.0.0a1）：早期预览，预计会发生重大变化
  • Beta（例如 1.0.0b1）：功能完整，可能发生小幅变化
  • Release Candidate（例如 1.0.0rc1）：稳定版本发布前的最终测试

​
另请参阅

Connect these docs to Claude, VSCode, and more via MCP for real-time answers.
Edit this page on GitHub or file an issue.