> ## 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` 格式，如 [语义版本控制](https://semver.org/) 所定义。

* **主版本**：需要代码更改的破坏性 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**。

## 发布周期

<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`）包括：

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

## 版本支持策略

* **最新主版本**：完全支持并进行活跃开发（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 之前的包

有关发布状态和支持时间表的详细信息，请参阅 [发布策略](/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"}}
  # Upgrade to the latest version
  npm update langchain @langchain/core

  # Install a specific version
  npm install langchain@1.0.0 @langchain/core@1.0.0
  ```

  ```bash LangGraph theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
  # Upgrade to the latest version
  npm update @langchain/langgraph

  # Install a specific version
  npm install @langchain/langgraph@1.0.0
  ```
</CodeGroup>

## 预发布版本

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

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

## 参见

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

***

<div className="source-links">
  <Callout icon="edit">
    [Edit this page on GitHub](https://github.com/langchain-ai/docs/edit/main/src/i18n\zh-CN\oss\versioning.mdx) or [file an issue](https://github.com/langchain-ai/docs/issues/new/choose).
  </Callout>

  <Callout icon="terminal-2">
    [Connect these docs](/use-these-docs) to Claude, VSCode, and more via MCP for real-time answers.
  </Callout>
</div>