# Flutter SDK 归档列表

> 所有 Flutter SDK 的版本列表：稳定版 (stable)、beta 版和主分支 (main)。



:::important
国内的网络环境下可能需要对 Flutter 工具进行一些额外配置，
请参考文档 [在中国网络环境下使用 Flutter][]。
:::

[using Flutter in China]: /community/china
[在中国网络环境下使用 Flutter]: https://docs.flutter.cn/community/china/


## Overview

## 概览

The Flutter SDK archive is a collection of all previous versions of the
Flutter SDK. This archive is useful for developers who need to use an older
version of Flutter for compatibility reasons or to investigate bugs.

Flutter SDK 归档列表是 Flutter SDK 以前所有版本的集合。
对于出于兼容性原因或调查错误而需要使用旧版本 Flutter 的开发人员来说，该归档列表非常有用。

After you download a release, to set up Flutter,
follow the [manual installation instructions][manual-install].

下载 Flutter SDK 后，请按照 [手动安装指南][manual-install] 来配置 Flutter。

The archive includes Flutter SDKs for Windows, macOS, and Linux on the
following [channels][]:

该归档列表包括以下 [渠道 (channel)][channels] 的 Flutter SDK（Windows、macOS 和 Linux）：

*   **Stable channel**: This channel contains the
    most stable Flutter builds. Roughly every third beta version is promoted
    to the stable version. The stable channel is the recommended channel for
    new users and for production app releases.

    **Stable channel**：该渠道 (channel) 包含
    最稳定的 Flutter 版本。大概每三个 beta 版本就会提升到稳定 (stable) 版本。
    稳定渠道 (stable channel) 是新开发者和生产应用发布最推荐的渠道 (channel)。

*   **Beta channel**: This channel is the most recent version of Flutter that is
    available, but it is not yet stable. The beta branch is usually released
    on the first Wednesday of the month. A fix will typically end up in the
    beta channel about two weeks after it lands in the main channel.
    Releases are distributed as [installation bundles][].

    **Beta channel**：该渠道 (channel) 是 Flutter 的最新版本，但尚未稳定。
    beta 分支通常在每月的第一个星期三发布。
    一个修复通常会在 main channel 发布两周后进入 beta channel。
    beta channel 会以 [安装包][installation bundles] 的形式发布

*   **Main channel**: This channel has the newest features, but it hasn't been fully
    tested and might have some bugs. We don't recommend using it unless you're
    contributing to Flutter itself.

    **Main channel**：该渠道 (channel) 会有最新的特性，但尚未经过全面测试，
    可能会存在一些 Bug。我们不建议你使用它，除非你要为 Flutter 本身做出贡献。

The following information is available for each Flutter release in the
SDK archive:

SDK 归档列表中的每个 Flutter 版本都有以下信息：

*   **Flutter version**: The version number of the Flutter SDK
    (for example, 3.35.0, 2.10.5) follows a modified
    [calendar versioning][] scheme called _CalVer_.
    For more information, visit the [Flutter SDK versioning][] page.

    **Flutter 版本**：Flutter SDK 的版本号（例如 3.35.0、2.10.5）。
    该版本号遵循 [日历化版本 (CalVer)][calendar versioning] 规范，
    更多详细信息，请查看 [Flutter SDK 版本][Flutter SDK versioning]。

*   **Architecture**: The processor architecture the SDK is built for
    (for example, x64, arm64). This specifies the type of processor the SDK is
    compatible with.

    **架构**：SDK 适用的处理器架构（例如 x64、arm64）。
    这指定了 SDK 兼容的处理器类型。

*   **Ref**: The git commit hash that uniquely identifies the specific codebase
    used for that release.

    **Ref**：唯一标识该版本特定代码仓库的 git 提交哈希值 (hash)。

*   **Release Date**: The date when that particular Flutter version was
    officially released.

    **发布日期**：当前 Flutter 版本正式发布的日期。

*   **Dart version**: The corresponding version of the Dart SDK included in the
    Flutter SDK release.

    **Dart 版本**：Flutter SDK 中包含的 Dart SDK 的对应版本。

*   **Provenance**: Provides details about the build process and origin of the
    SDK, potentially including information about security attestations or
    build systems used. Results are returned as JSON.

    **出处/来源**：提供有关 SDK 构建过程和来源的详细信息，
    可能包括所适用的安全证明或构建系统的信息。
    结果以 JSON 格式返回。

[calendar versioning]: https://calver.org/
[Flutter SDK versioning]: https://github.com/flutter/flutter/blob/main/docs/releases/Release-versioning.md

## Public release windows

## 公开发布窗口

Predictability is key to landing complex features safely.
We use public release windows to provide the community with
the visibility needed to plan ahead.
By explicitly calling out branch cutoff dates and release targets,
we enable everyone to align their development cycles and
coordinate feature landing effectively.

可预测性是安全合入复杂特性的关键。
我们通过公开发布窗口，为社区提供提前规划所需的可见性。
通过明确给出分支截止日期和发布目标，
我们让每个人都能对齐各自的开发周期，
并高效地协调特性的合入。

### What is a branch cutoff date?

### 什么是分支截止日期？

This date is the deadline for pull requests to
land in the default branches (`main` for Dart and `master` for Flutter) to
guarantee inclusion in the next stable release.

该日期是 pull request 合入默认分支（Dart 为 `main`，Flutter 为 `master`）的最后期限，
只有在此期限前合入，才能保证被纳入下一个稳定版发布。

* **Before cutoff:** Your PR will ship in the next stable version.

  **截止日期之前：** 你的 PR 将随下一个稳定版本一起发布。

* **After cutoff:** Your PR will wait for the following cycle.

  **截止日期之后：** 你的 PR 将等到下一个发布周期。

### 2026 schedule

### 2026 年发布计划

| <t>Flutter version</t><t>Flutter 版本</t> | <t>Release target</t><t>发布目标</t> | <t>Branch cutoff date</t><t>分支截止日期</t> |
|-----------------|----------------|--------------------|
| Flutter 3.41    | February, 2026 | 2026-01-06         |
| Flutter 3.44    | May, 2026      | 2026-04-07         |
| Flutter 3.47    | August, 2026   | 2026-07-07         |
| Flutter 3.50    | November, 2026 | 2026-10-06         |

{:.table}

---

## Stable channel

## Stable 渠道

<Tabs key="os-archive-tabs">
    <Tab name="Windows">
        <ArchiveTable os="Windows" channel="stable" />
    </Tab>
    <Tab name="macOS">
        <ArchiveTable os="macOS" channel="stable" />
    </Tab>
    <Tab name="Linux">
        <ArchiveTable os="Linux" channel="stable" />
    </Tab>
</Tabs>

## Beta channel

## Beta 渠道

<Tabs key="os-archive-tabs">
    <Tab name="Windows">
        <ArchiveTable os="Windows" channel="beta" />
    </Tab>
    <Tab name="macOS">
        <ArchiveTable os="macOS" channel="beta" />
    </Tab>
    <Tab name="Linux">
        <ArchiveTable os="Linux" channel="beta" />
    </Tab>
</Tabs>

:::tip
To see what's changed in a beta release, compare the version tags on GitHub.

若要查看某个 beta 版本有哪些变更，可在 GitHub 上比较版本标签 (tag)。

1. Find the version number (tag) you want to see (for example, `3.38.0-0.2.pre`).

   找到你想查看的版本号（tag，例如 `3.38.0-0.2.pre`）。

2. Find the previous version number (for example, `3.38.0-0.1.pre`).

   找到上一个版本号（例如 `3.38.0-0.1.pre`）。

3. Go to the [GitHub compare page](https://github.com/flutter/flutter/compare).

   打开 [GitHub 比较页面](https://github.com/flutter/flutter/compare)。

4. Select the older tag for the `base` field and the newer tag for the `compare` field.

   将较旧的 tag 选为 `base` 字段，将较新的 tag 选为 `compare` 字段。

For example: [`flutter/flutter@3.38.0-0.1.pre...3.38.0-0.2.pre`](https://github.com/flutter/flutter/compare/3.38.0-0.1.pre...3.38.0-0.2.pre)

例如：[`flutter/flutter@3.38.0-0.1.pre...3.38.0-0.2.pre`](https://github.com/flutter/flutter/compare/3.38.0-0.1.pre...3.38.0-0.2.pre)
:::

<a id="master-channel" aria-hidden="true"></a>

## Main channel

## Main 渠道

[Installation bundles][] are not available for the `main` channel
(which was previously known as the `master` channel).
However, you can get the SDK directly from
[GitHub repo][] by cloning the `main` channel and then
triggering a download of the SDK dependencies:

我们没有对 `main` channel
（以前是 `master` channel）
提供 [安装包][Installation bundles] 下载。
不过，你可以通过 `git clone` 
[Github 上 repo][GitHub repo] 的 `main` 分支来下载使用：

```console
$ git clone -b main https://github.com/flutter/flutter.git
$ ./flutter/bin/flutter --version
```

<a id="install-from-an-archive" aria-hidden="true"></a>

## More information

## 更多信息

- For instructions on installing Flutter from a downloaded SDK,
  see [Install Flutter manually][manual-install].

  当你下载 SDK 后，关于安装 Flutter 的说明，
  请参阅 [手动安装 Flutter][manual-install]。

- To learn what's new in the major Flutter builds,
  check out the [release notes][] page.

  要了解 Flutter 主要版本的新内容，
  请查看 [版本发行注记][release notes] 页。

- For details on how our installation bundles are structured,
  see [Installation bundles][].

  关于安装包结构的更多信息，请查看这个页面：
  [Flutter 安装包结构][Installation bundles]。

[channels]: https://github.com/flutter/flutter/blob/main/docs/releases/Flutter-build-release-channels.md
[manual-install]: /install/manual
[release notes]: /release/release-notes
[GitHub repo]: https://github.com/flutter/flutter
[Installation bundles]: https://github.com/flutter/flutter/blob/main/docs/infra/Flutter-Installation-Bundles.md

