Skip to main content
本页面解释了 LangChain 和 LangGraph 的发布政策。点击下方标签查看各组件的发布政策:
:::python LangChain 生态系统由不同组件包组成(例如 langchain-core、langchain、合作伙伴包等) ::: :::js LangChain 生态系统由不同组件包组成(例如 @langchain/core、langchain、合作伙伴包等) :::

发布节奏

:::python 自 LangChain 1.0 发布后,langchain 和 langchain-core 的 次要 版本(例如从 1.0.x 到 1.1.0)遵循语义版本规范,可能频繁发布。次要版本包含新功能和改进,但不包含破坏性变更。 ::: :::js 自 LangChain 1.0 发布后,langchain 和 @langchain/core 的 次要 版本(例如从 1.0.x 到 1.1.0)遵循语义版本规范,可能频繁发布。次要版本包含新功能和改进,但不包含破坏性变更。 :::补丁版本会频繁发布(每周最多几次),包含漏洞修复和小改进。

API 稳定性

:::python LLM 应用开发是快速演进的领域,我们持续从用户和社区中学习。因此,我们预期 langchain 和 langchain-core 的 API 将持续演进以更好地满足用户需求。 ::: :::js LLM 应用开发是快速演进的领域,我们持续从用户和社区中学习。因此,我们预期 langchain 和 @langchain/core 的 API 将持续演进以更好地满足用户需求。 :::采用语义版本规范后 LangChain 1.0 的特性:
  • 公共API的重大变更仅在主版本发布中发生(例如 2.0.0)
  • 次要版本升级(例如 1.0.0 到 1.1.0)添加新功能但不破坏现有功能
  • 补丁版本升级(例如 1.0.0 到 1.0.1)包含漏洞修复和小改进
我们通常会避免不必要的变更,并为即将移除的功能提供降级策略。

其他包的稳定性

LangChain 生态系统中其他包的稳定性可能有所不同:
  • 由LangChain维护的合作伙伴包(例如 langchain-openai 和 langchain-anthropic)遵循语义化版本管理并会在1.0版本后保持稳定。其他合作伙伴包可能采用不同的稳定性和版本管理策略,用户应参考对应包的文档获取更多信息。

弃用政策

我们通常会避免在引入更好替代方案前弃用功能。:::python 在LangChain 1.0的语义化版本管理机制下,弃用功能将在整个1.x版本系列中持续可用。破坏性变更(包括弃用功能的移除)仅在主版本发布(例如2.0)时生效。当功能在 langchain 或 langchain-core 中被标记为弃用时,我们将:
  • 在代码和文档中明确标注弃用状态
  • 提供向推荐替代方案的迁移指引
  • 通过所有1.x小版本持续为弃用功能提供安全更新 ::: :::js 在LangChain 1.0的语义化版本管理机制下,弃用功能将在整个1.x版本系列中持续可用。破坏性变更(包括弃用功能的移除)仅在主版本发布(例如2.0)时生效。
当功能在 langchain 或 @langchain/core 中被标记为弃用时,我们将:
  • 在代码和文档中明确标注弃用状态
  • 提供向推荐替代方案的迁移指引
  • 通过所有1.x小版本持续为弃用功能提供安全更新 :::
在特定情况下(例如未引发维护问题),我们可能允许弃用功能在代码库中保留更长时间以进一步降低用户负担。

长期支持(LTS)

LangChain采用长期支持(LTS)政策为生产应用提供稳定性:

版本状态定义

包将标记为以下状态之一:
  • ACTIVE:当前持续开发中,包含漏洞修复、安全补丁和新功能
  • MAINTENANCE:仅接收安全补丁和关键漏洞修复,不新增功能

当前LTS版本

LangChain 1.0 已被标记为长期支持(LTS)版本:
  • 状态: 直至2.0版本发布前为活跃状态
  • 支持周期: 2.0版本发布后,1.0将进入维护模式至少一年
  • 语义版本兼容性: 用户可安全升级至次要版本(如1.0→1.1)且无破坏性变更

遗留版本支持

LangChain 0.3:
  • 状态: 维护模式
  • 支持周期: 直至2026年12月
  • 支持内容: 安全补丁和关键缺陷修复

官方原文:src/oss/release-policy.mdx · 非官方翻译,译文由 AI 生成,以英文原文为准。
Last modified on November 3, 2026