Skip to main content

Documentation Index

Fetch the complete documentation index at: https://langchain-zh.cn/llms.txt

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

我们的开源版本号遵循 MAJOR.MINOR.PATCH 格式，如 语义版本控制 所定义。
  • 主版本：需要代码更改的破坏性 API 更新。
  • 次版本：保持向后兼容的新功能和改进。
  • 修订版：Bug 修复和微小改进。
例如：
  • 1.0.0：首个包含生产就绪 API 的稳定版本
  • 1.1.0：以向后兼容的方式添加新功能
  • 1.0.1：向后兼容的 Bug 修复

​
API 稳定性

我们按如下方式传达 API 的稳定性：

​
稳定 API

所有没有特殊前缀的 API 都被视为稳定且可用于生产环境。我们为稳定功能维护向后兼容性，仅在主要版本中引入破坏性更改。

​
Beta API

标记为 beta 的 API 功能已完成，但可能会根据用户反馈进行微小更改。它们可用于生产环境，但在未来的版本中可能需要少量调整。

​
Alpha API

标记为 alpha 的 API 是实验性的，可能会发生重大更改。在生产环境中使用时请谨慎。

​
已弃用 API

标记为 deprecated 的 API 将在未来的主要版本中被移除。在可能的情况下，我们会指定预期的移除版本。处理弃用事项的方法如下：
  1. 切换到推荐的替代 API
  2. 遵循迁移指南（随主要版本一起发布）
  3. 在可用时使用自动化迁移工具

​
内部 API

某些 API 通过以下方式明确标记为“内部”：
  • 某些文档引用了内部内容并明确指出它们是内部的。如果文档说明某内容是内部的，它可能会发生变化。
  • 以前导下划线（_）为前缀的函数、方法和其他对象。这是表明某物为私有的标准 Python 惯例；如果任何方法以单个 _ 开头，则它是内部 API。
    • 例外情况： 某些方法以前导下划线 _ 为前缀，但不包含实现。这些方法旨在由提供实现的子类重写。此类方法通常属于 LangChain 的 公共 API。

​
发布周期

主版本发布（例如，1.0.0 → 2.0.0）可能包括：
  • 破坏性 API 更改
  • 移除已弃用的功能
  • 重大的架构改进
我们提供：
  • 详细的迁移指南
  • 在可能的情况下提供自动化迁移工具
  • 对上一个主要版本的延长支持期
次版本发布（例如，1.0.0 → 1.1.0）包括：
  • 新功能和能力
  • 性能改进
  • 新的可选参数
  • 向后兼容的增强功能
修订版发布（例如，1.0.0 → 1.0.1）包括：
  • Bug 修复
  • 安全更新
  • 文档改进
  • 不改变 API 的性能优化

​
版本支持策略

  • 最新主版本：完全支持并进行活跃开发（ACTIVE 状态）
  • 上一主版本：在下一个主要版本发布后的 12 个月内提供安全更新和关键 Bug 修复（MAINTENANCE 状态）
  • 旧版本：仅提供社区支持

​
长期支持 (LTS) 发布

LangChain 和 LangGraph 1.0 均被指定为 LTS 发布：
  • 版本 1.0 将保持 ACTIVE 状态，直到版本 2.0 发布
  • 版本 2.0 发布后，版本 1.0 将进入 MAINTENANCE 模式至少 1 年
  • LTS 发布遵循语义版本控制 (semver)，允许在次要版本之间安全升级
  • 遗留版本（LangChain 0.3 和 LangGraph 0.4）处于 MAINTENANCE 模式，直到 2026 年 12 月

​
1.0 之前的包

Deep Agents (deepagents) 是一个处于活跃开发中的 1.0 之前包。作为一个快速演进的包，API 可能会在次要版本之间发生变化，尽管我们在可能的情况下尽量减少破坏性更改。Deep Agents 在达到版本 1.0 后将采用与 LangChain 和 LangGraph 相同的 LTS 策略。 有关发布状态和支持时间表的详细信息，请参阅 发布策略。

​
检查您的版本

要检查您安装的版本： 
import langchain_core
print(langchain_core.__version__)

​
升级

# Upgrade to the latest version
pip install -U langchain-core langchain

# Upgrade to a specific version
pip install langchain-core==1.0.0

​
预发布版本

我们偶尔会发布 alpha 和 beta 版本以供早期测试：
  • Alpha（例如，1.0.0a1）：早期预览，预计会有重大更改
  • Beta（例如，1.0.0b1）：功能已完成，可能会有微小更改
  • Release Candidate（例如，1.0.0rc1）：稳定发布前的最终测试

​
参见

Edit this page on GitHub or file an issue.
Connect these docs to Claude, VSCode, and more via MCP for real-time answers.