本页说明 LangChain 和 LangGraph 的发布策略。点击下面的标签页查看各自的发布策略：
LangChain 生态系统由不同的组件包组成，例如 langchain-core、langchain、合作伙伴包等。

​
发布节奏

随着 LangChain 1.0 发布，langchain 和 langchain-core 的次要版本发布（例如从 1.0.x 到 1.1.0）遵循语义化版本控制，并且可能频繁发布。次要版本包含新功能和改进，但不包含破坏性变更。补丁版本会频繁发布，最高可达每周数次，因为它们包含 bug 修复和小幅改进。

​
API 稳定性

LLM 应用开发是一个快速演进的领域，LangChain 会持续从用户和社区中学习。因此，langchain 和 langchain-core 中的 API 会继续演进，以更好地满足用户需求。LangChain 1.0 采用语义化版本控制后：
  • 公共 API 的破坏性变更只会出现在主版本发布中（例如 2.0.0）
  • 次要版本升级（例如 1.0.0 到 1.1.0）会添加新功能，但不包含破坏性变更
  • 补丁版本升级（例如 1.0.0 到 1.0.1）包含 bug 修复和小幅改进
LangChain 通常会避免不必要的变更，并为将要移除的功能提供弃用策略。

​
其他包的稳定性

LangChain 生态系统中其他包的稳定性可能有所不同：
  • 由 LangChain 维护的合作伙伴包（例如 langchain-openai 和 langchain-anthropic）遵循语义化版本控制，并预期在 1.0 之后保持稳定。其他合作伙伴包可能遵循不同的稳定性和版本策略，用户应参考这些包的文档获取更多信息。

​
弃用策略

在有更好的替代方案之前，LangChain 通常会避免弃用功能。按照 LangChain 1.0 的语义化版本控制方法，已弃用功能会在整个 1.x 发布系列中继续工作。破坏性变更，包括移除已弃用功能，只会出现在主版本发布中（例如 2.0）。当 langchain 或 langchain-core 中的某项功能被弃用时，LangChain 会：
  • 在代码和文档中清楚标记为已弃用
  • 提供迁移到推荐替代方案的指导
  • 在所有 1.x 次要版本中为已弃用功能提供安全更新
在某些情况下，如果已弃用功能不会造成维护问题，LangChain 可能允许它们在代码库中保留更久，以进一步降低用户负担。

​
长期支持 (LTS)

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

​
发布状态定义

包会标记为以下状态之一：
  • ACTIVE：当前处于活跃开发状态，包括 bug 修复、安全补丁和新功能
  • MAINTENANCE：接收所有安全补丁和关键 bug 修复，但不接收新功能

​
当前 LTS 版本

LangChain 1.0 被指定为 LTS 版本：
  • 状态：在 2.0 发布前为 ACTIVE
  • 支持周期：2.0 发布后，1.0 会进入 MAINTENANCE 模式至少 1 年
  • 语义化版本兼容性：用户可以在次要版本之间升级（例如 1.0 到 1.1），不会遇到破坏性变更

​
旧版本支持

LangChain 0.3:
  • 状态：MAINTENANCE 模式
  • 支持周期：到 2026 年 12 月
  • 支持内容：安全补丁和关键 bug 修复
Connect these docs to Claude, VSCode, and more via MCP for real-time answers.
Edit this page on GitHub or file an issue.