Skip to main content

Documentation Index

Fetch the complete documentation index at: https://nvd-54.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

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

​
发布节奏

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

​
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）包含 Bug 修复和小幅改进
我们通常会尽量避免不必要的变更，并为即将移除的功能提供弃用政策。

​
其他包的稳定性

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：当前活跃开发，包括 Bug 修复、安全补丁和新功能
  • MAINTENANCE：接收所有安全补丁和关键 Bug 修复，但不添加新功能

​
当前 LTS 版本

LangChain 1.0 被指定为 LTS 版本：
  • 状态：ACTIVE，直到 2.0 发布
  • 支持期：2.0 发布后，1.0 将进入 MAINTENANCE 模式至少 1 年
  • Semver 合规：用户可以在次版本之间升级（例如 1.0 到 1.1）而不会遇到破坏性变更

​
旧版本支持

LangChain 0.3：
  • 状态：MAINTENANCE 模式
  • 支持期：至 2026 年 12 月
  • 支持包括：安全补丁和关键 Bug 修复

​
特殊注意事项

langchain-community 0.4：由于社区贡献和第三方集成的性质，langchain-community 可能在次版本中包含破坏性变更。它以 0.4 版本发布以反映这种不同的稳定性政策。
连接这些文档到 Claude、VSCode 等工具，通过 MCP 获取实时答案。
在 GitHub 上编辑此页面或提交 issue。