Skip to main content
本页面解释了 LangChain 和 LangGraph 的发布策略。点击下面的选项卡查看各自的发布策略：
LangChain 生态系统由不同的组件包组成（例如 @langchain/core、langchain、@langchain/community、合作伙伴包等）。

​
发布节奏

随着 LangChain 1.0 的发布，langchain 和 @langchain/core 的 次要 (minor) 版本（例如，从 1.0.x 到 1.1.0）遵循语义化版本控制，并且可能会频繁发布。次要版本包含新功能和改进，但不包含重大更改。补丁 (Patch) 版本发布频繁，每周可能发布几次，因为它们包含错误修复和小的改进。

​
API 稳定性

LLM 应用程序的开发是一个快速发展的领域，我们要不断向用户和社区学习。因此，我们预计 langchain 和 @langchain/core 中的 API 将继续演进，以更好地服务于用户的需求。随着 LangChain 1.0 采用语义化版本控制：
  • 对公共 API 的重大更改仅会出现在主要 (major) 版本发布中（例如 2.0.0）
  • 次要版本升级（例如 1.0.0 到 1.1.0）在不进行重大更改的情况下添加新功能
  • 补丁版本升级（例如 1.0.0 到 1.0.1）包含错误修复和小的改进
我们会尽量避免进行不必要的更改，并为将要移除的功能提供弃用策略。

​
其他包的稳定性

LangChain 生态系统中其他包的稳定性可能有所不同：
  • 由 LangChain 维护的合作伙伴包（如 langchain-openai 和 langchain-anthropic）遵循语义化版本控制，预计在 1.0 后保持稳定。其他合作伙伴包可能遵循不同的稳定性和版本控制策略，用户应参考这些包的文档以获取更多信息。
  • @langchain/community 是一个社区维护的包，包含第三方集成。由于社区贡献和第三方依赖的性质，@langchain/community 不遵循与 langchain 和 @langchain/core 相同的严格语义化版本控制策略。有关详细信息，请参阅“长期支持”下的“特殊注意事项”部分。

​
弃用策略

通常，在有更好的替代方案之前，我们会避免弃用功能。随着 LangChain 1.0 的语义化版本控制方法的采用，已弃用的功能将在整个 1.x 发布系列中继续工作。重大更改（包括删除已弃用的功能）仅会出现在主要版本发布中（例如 2.0）。当 langchain 或 @langchain/core 中的功能被弃用时，我们将：
  • 在代码和文档中明确将其标记为已弃用
  • 提供迁移至推荐替代方案的指南
  • 在所有 1.x 次要版本中为已弃用的功能提供安全更新
在某些情况下，如果已弃用的功能没有引起维护问题，我们可能会允许它们在代码库中保留更长时间，以进一步减轻用户的负担。

​
长期支持 (LTS)

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

​
发布状态定义

包被标记为以下状态之一：
  • ACTIVE (活跃)：当前正在积极开发，包括错误修复、安全补丁和新功能
  • MAINTENANCE (维护)：接收所有安全补丁和关键错误修复，但没有新功能

​
当前 LTS 版本

LangChain 1.0 被指定为 LTS 版本：
  • 状态：ACTIVE (活跃)，直到 2.0 发布
  • 支持期：2.0 发布后，1.0 将进入 MAINTENANCE (维护) 模式至少 1 年
  • 语义化版本合规性：用户可以在次要版本之间升级（例如 1.0 到 1.1）而不会出现重大更改

​
旧版本支持

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

​
特殊注意事项

@langchain/community 1.0：由于社区贡献和第三方集成的性质，@langchain/community 可能会在次要版本发布中出现重大更改。
在 GitHub 上编辑此页面 或 提交 issue。
将这些文档连接 到 Claude、VSCode 等，通过 MCP 获取实时解答。