版本管理

我们的 OSS 版本号遵循以下格式：MAJOR.MINOR.PATCH，如 语义化版本 所定义。

• 主版本（Major）：需要更改代码的破坏性 API 更新。
• 次版本（Minor）：保持向后兼容的新功能和改进。
• 补丁（Patch）：缺陷修复和小幅改进。

例如：

• 1.0.0：首个稳定版本，具有可用于生产的 API
• 1.1.0：以向后兼容的方式添加的新功能
• 1.0.1：向后兼容的缺陷修复

API 稳定性

我们按如下方式传达 API 的稳定性：

稳定的 API

所有不带特殊前缀的 API 都被视为稳定的，可用于生产。我们为稳定功能维护向后兼容性，仅在主版本中引入破坏性变更。

Beta API

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

Alpha API

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

已弃用的 API

标记为 deprecated 的 API 将在未来的主版本中移除。在可能的情况下，我们会指明预计移除的版本。要处理弃用：

1. 切换到推荐的替代 API
2. 遵循迁移指南（随主版本一同发布）
3. 在可用时使用自动化迁移工具

内部 API

某些 API 通过几种方式被显式标记为 "internal"：

• 某些文档会提到内部实现，并明确说明它们是内部的。如果文档说某个东西是内部的，它可能会发生变化。
• 以下划线（_）开头的函数、方法和其他对象。这是 Python 中表示某项为私有的标准约定；如果任何方法以单个 _ 开头，它就是内部 API。
  • 例外： 某些方法以 _ 为前缀 , 但不包含实现。这些方法是有意由提供实现的子类来重写的。此类方法通常是 LangChain Public API（公共 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 月

1.0 之前的包

Deep Agents（deepagents）是一个处于积极开发中的 1.0 之前版本包。作为一个快速演进的包，其 API 可能会在次版本之间发生变化，不过我们会尽可能减少破坏性变更。Deep Agents 在达到 1.0 版本后，将采用与 LangChain 和 LangGraph 相同的 LTS 策略。

有关发布状态和支持时间线的详细信息，请参阅 发布策略。

检查你的版本

检查已安装的版本：

LangChain

import langchain_core
print(langchain_core.__version__)

LangGraph

import langgraph
print(langgraph.__version__)

升级

LangChain

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

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

LangGraph

# Upgrade to the latest version
pip install -U langgraph

# Upgrade to a specific version
pip install langgraph==1.0.0

Deep Agents

# Upgrade to the latest version
pip install -U deepagents

# Upgrade to a specific version
pip install deepagents==0.1.0

预发布版本

我们偶尔会发布 alpha 和 beta 版本用于早期测试：

• Alpha（例如 1.0.0a1）：早期预览，预计会有重大更改
• Beta（例如 1.0.0b1）：功能完整，可能会有小幅更改
• Release Candidate（例如 1.0.0rc1）：稳定版发布前的最终测试

另请参阅

• 发布策略 - 详细的发布和弃用策略

---