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

​
发布节奏

随着LangChain 1.0的发布，次要版本（例如，从 1.0.x 到 1.1.0）的 langchain 和 @langchain/core 遵循语义版本控制，并可能频繁发布。次要版本包含新功能和改进，但不包括破坏性更改。补丁版本发布频率较高，每周可达几次，因为它们包含错误修复和细微改进。

​
API稳定性

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版本后保持稳定。其他合作伙伴包可能遵循不同的稳定性和版本控制策略，用户应参考这些包的文档以获取更多信息。
  • @langchain/community 是一个由社区维护的包含第三方集成的包。由于社区贡献和第三方依赖的性质，@langchain/community 不遵循与 langchain 和 @langchain/core 相同的严格语义版本控制策略。有关更多详细信息，请参阅长期支持部分下的“特殊注意事项”部分。

​
弃用策略

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

​
长期支持（LTS）

LangChain遵循长期支持（LTS）策略，以确保生产应用的稳定性：

​
发布状态定义

软件包被标记为以下状态之一：
  • 活跃：当前处于活跃开发状态，包括错误修复、安全补丁和新增功能
  • 维护：接收所有安全补丁和关键错误修复，但没有新增功能

​
当前长期支持版本

LangChain 1.0 被指定为长期支持版本：
  • 状态：在 2.0 版本发布前保持 活跃
  • 支持周期：2.0 版本发布后，1.0 将进入 维护模式 至少 1 年
  • Semver 兼容性：用户可以在次要版本之间升级（例如，从 1.0 升级到 1.1），无需进行破坏性更改

​
兼容旧版本支持

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

​
特别注意事项

@langchain/community 1.0：由于社区贡献和第三方集成的性质，@langchain/community 在小版本更新中可能会有破坏性更改。
在GitHub上编辑此页面的源代码。
通过MCP将这些文档编程连接到Claude、VSCode等，以获取实时答案。