跳到主要内容
本页面解释了 LangChain 和 LangGraph 的发布策略。点击下方标签页可查看各自的发布策略。
  • LangChain
  • LangGraph
LangChain 生态系统由不同的组件包组成(例如,langchain-core, langchain, langchain-community, 合作伙伴包等)。

发布节奏

随着 LangChain 1.0 的发布,langchainlangchain-core次要版本(例如,从 1.0.x1.1.0)遵循语义化版本控制,并且可能会频繁发布。次要版本包含新功能和改进,但不包含破坏性更改。补丁版本发布频繁,每周最多发布几次,因为它们包含错误修复和次要改进。

API 稳定性

LLM 应用程序的开发是一个快速发展的领域,我们不断向用户和社区学习。因此,我们期望 langchainlangchain-core 中的 API 将继续发展,以更好地满足用户的需求。随着 LangChain 1.0 采用语义化版本控制:
  • 公共 API 的破坏性更改只会在主要版本发布时发生(例如,2.0.0
  • 次要版本更新(例如,1.0.01.1.0)添加新功能,不包含破坏性更改
  • 补丁版本更新(例如,1.0.01.0.1)包含错误修复和次要改进
我们通常会尽量避免不必要的更改,并将为正在删除的功能提供弃用策略。

其他包的稳定性

LangChain 生态系统中其他包的稳定性可能有所不同
  • 由 LangChain 维护的合作伙伴包(如 langchain-openailangchain-anthropic)遵循语义化版本控制,预计在 1.0 版本后保持稳定。其他合作伙伴包可能遵循不同的稳定性和版本控制策略,用户应查阅这些包的文档以获取更多信息。
  • langchain-community 是一个由社区维护的包,其中包含第三方集成。由于集成数量众多,langchain-community 不遵循与 langchainlangchain-core 相同的严格语义化版本控制策略。有关详细信息,请参阅长期支持下的“特殊考虑”部分。

弃用策略

通常,我们会在有更好的替代方案可用之前避免弃用功能。随着 LangChain 1.0 采用语义化版本控制,弃用的功能将在整个 1.x 发布系列中继续运行。破坏性更改,包括弃用功能的移除,只会在主要版本发布时发生(例如,2.0)。langchainlangchain-core 中的某个功能被弃用时,我们将:
  • 在代码和文档中明确标记为已弃用
  • 提供迁移到推荐替代方案的指南
  • 在所有 1.x 次要版本中为弃用功能提供安全更新
在某些情况下,如果弃用的功能没有引起维护问题,我们可能会允许它们在代码库中保留更长时间,以进一步减轻用户的负担。

长期支持(LTS)

LangChain 遵循长期支持(LTS)策略,为生产应用程序提供稳定性

发布状态定义

软件包被标记为以下状态之一
  • ACTIVE:当前处于活跃开发中,包括错误修复、安全补丁和新功能
  • MAINTENANCE:接收所有安全补丁和关键错误修复,但不包含新功能

当前 LTS 版本

LangChain 1.0 被指定为 LTS 版本
  • 状态:在 2.0 发布之前保持 ACTIVE 状态
  • 支持期限:2.0 发布后,1.0 将进入 MAINTENANCE 模式至少 1 年
  • 语义化版本兼容性:用户可以在次要版本之间升级(例如,1.0 到 1.1),而不会遇到破坏性更改

遗留版本支持

LangChain 0.3:
  • 状态:MAINTENANCE 模式
  • 支持期限:直到 2026 年 12 月
  • 支持内容:安全补丁和关键错误修复

特殊考虑

langchain-community 0.4:由于社区贡献和第三方集成的性质,langchain-community 在次要版本中可能会有破坏性更改。它已作为 0.4 版本发布,以反映这种不同的稳定性策略。

以编程方式连接这些文档到 Claude、VSCode 等,通过 MCP 获取实时答案。
© . This site is unofficial and not affiliated with LangChain, Inc.