> ## Documentation Index
> Fetch the complete documentation index at: https://cndoc-langchain.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 版本控制

我们的开源版本号遵循以下格式：`MAJOR.MINOR.PATCH`，如[语义化版本控制](https://semver.org/)所定义。

* **主版本号 (Major)**：需要代码变更的破坏性 API 更新。
* **次版本号 (Minor)**：保持向后兼容的新功能和改进。
* **修订号 (Patch)**：错误修复和小幅改进。

例如：

* `1.0.0`：首个稳定版本，包含可用于生产的 API
* `1.1.0`：以向后兼容的方式添加新功能
* `1.0.1`：向后兼容的错误修复

## 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** 的一部分。

## 发布周期

<AccordionGroup>
  <Accordion title="主版本发布">
    主版本发布（例如，`1.0.0` → `2.0.0`）可能包括：

    * 破坏性 API 变更
    * 移除已弃用的功能
    * 重大的架构改进

    我们提供：

    * 详细的迁移指南
    * 在可能的情况下提供自动迁移工具
    * 对前一个主版本的延长支持期
  </Accordion>

  <Accordion title="次版本发布">
    次版本发布（例如，`1.0.0` → `1.1.0`）包括：

    * 新功能和能力
    * 性能改进
    * 新的可选参数
    * 向后兼容的增强功能
  </Accordion>

  <Accordion title="修订版发布">
    修订版发布（例如，`1.0.0` → `1.0.1`）包括：

    * 错误修复
    * 安全更新
    * 文档改进
    * 不涉及 API 变更的性能优化
  </Accordion>
</AccordionGroup>

## 版本支持策略

* **最新主版本**：完全支持并进行活跃开发（ACTIVE 状态）
* **前一个主版本**：在下一个主版本发布后 12 个月内提供安全更新和关键错误修复（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 之前的包

有关发布状态和支持时间线的详细信息，请参阅[发布策略](/oss/javascript/release-policy)。

## 检查您的版本

要检查您安装的版本：

<CodeGroup>
  ```javascript LangChain theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
  import { version } from "langchain/package.json";
  console.log(version);
  ```

  ```javascript LangGraph theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
  import { version } from "@langchain/langgraph/package.json";
  console.log(version);
  ```
</CodeGroup>

## 升级

<CodeGroup>
  ```bash LangChain theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
  # 升级到最新版本
  npm update langchain @langchain/core

  # 安装特定版本
  npm install langchain@1.0.0 @langchain/core@1.0.0
  ```

  ```bash LangGraph theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
  # 升级到最新版本
  npm update @langchain/langgraph

  # 安装特定版本
  npm install @langchain/langgraph@1.0.0
  ```
</CodeGroup>

## 预发布版本

我们偶尔会发布 alpha 和 beta 版本以供早期测试：

* **Alpha**（例如，`1.0.0a1`）：早期预览，预计会有重大更改
* **Beta**（例如，`1.0.0b1`）：功能完整，可能会有小幅更改
* **候选发布版**（例如，`1.0.0rc1`）：稳定版发布前的最终测试

## 另请参阅

* [发布策略](/oss/javascript/release-policy) - 详细的发布和弃用政策

***

<div className="source-links">
  <Callout icon="terminal-2">
    [将这些文档](/use-these-docs)通过 MCP 连接到 Claude、VSCode 等，以获取实时答案。
  </Callout>

  <Callout icon="edit">
    [在 GitHub 上编辑此页面](https://github.com/langchain-ai/docs/edit/main/src/oss/versioning.mdx) 或 [提交问题](https://github.com/langchain-ai/docs/issues/new/choose)。
  </Callout>
</div>