跳到主内容

软件要求

#

要编写和编译用于 Web 的 Flutter 代码，请安装以下软件包。

操作系统

#

Flutter 支持在 macOS 12 (Monterey) 或更高版本上开发。本指南假定您的 Mac 运行 zsh 作为您的 默认 Shell。

一些 Flutter 组件需要 Rosetta 2 翻译过程。如果你在 Apple Silicon (ARM) Mac 上进行开发，请安装 Rosetta 2

sudo softwareupdate --install-rosetta --agree-to-license

开发工具

#

下载并安装以下软件包。

  • Google Chrome 用于调试 Web 应用的 JavaScript 代码。
  • Git 用于管理 Flutter 版本和您自己的源代码版本控制。要检查您是否已安装 git，请在您的终端中输入 git version。如果您需要安装 git，请运行 xcode-select --install。

上述软件的开发者提供这些产品的支持。要解决安装问题，请查阅该产品的文档。

文本编辑器或集成开发环境

#

你可以使用任何文本编辑器或集成开发环境 (IDE) 结合 Flutter 的命令行工具来构建应用。

使用带有 Flutter 扩展或插件的 IDE 可提供代码补全、语法高亮、小部件编辑辅助、调试及其他功能。

流行的选项包括

安装 Flutter SDK

#

要安装 Flutter SDK，你可以使用 VS Code Flutter 扩展，或自行下载并安装 Flutter 包。

使用 VS Code 安装 Flutter

#

要按照这些说明安装 Flutter，请验证您已安装 Visual Studio Code 和 VS Code 版 Flutter 扩展。

提示 VS Code 安装 Flutter

#

  1. 启动 VS Code。

  2. 要打开命令面板，请按 Command + Shift + P。

  3. 在命令面板中，输入 flutter。

  4. 选择Flutter: 新建项目。

  5. VS Code 会提示你定位电脑上的 Flutter SDK。

    1. 如果你已安装 Flutter SDK，请点击定位 SDK。

    2. 如果你未安装 Flutter SDK，请点击下载 SDK。

      如果您尚未按照开发工具先决条件中的说明安装 Git，此选项会将您带到 Flutter 安装页面。

  6. 当提示哪个 Flutter 模板？时，请忽略。按 Esc。你可以在检查开发环境设置后创建一个测试项目。

下载 Flutter SDK

#

  1. 当显示选择 Flutter SDK 文件夹对话框时，选择你想要安装 Flutter 的位置。

    VS Code 会首先将你定位到用户配置文件目录。请选择其他位置。

    考虑使用 ~/development/

  2. 点击克隆 Flutter。

    下载 Flutter 时，VS Code 会显示以下弹窗通知：

    Downloading the Flutter SDK. This may take a few minutes.
    Initializing the Flutter SDK. This may take a few minutes.

    下载和安装需要几分钟。如果你怀疑下载已卡住，请点击取消，然后重新开始安装。

    Flutter 安装成功后，VS Code 会显示此弹窗通知：

    Do you want to add the Flutter SDK to PATH so it's accessible
in external terminals?

  3. 点击添加 SDK 到 PATH。

    成功时，会显示通知

    The Flutter SDK was added to your PATH

  4. VS Code 可能会显示 Google Analytics 通知。

    如果你同意，点击确定。

  5. 在所有终端窗口中启用 flutter

    1. 关闭，然后重新打开所有终端窗口。
    2. 重新启动 VS Code。

下载然后安装 Flutter

#

要安装 Flutter，请从其存档下载 Flutter SDK 包，将该包移动到你希望存储的位置，然后解压 SDK。

  1. 下载以下安装包以获取 Flutter SDK 的最新稳定版本。

    英特尔处理器Apple 芯片
    (加载中...)(加载中...)

    对于其他发布渠道和旧版本，请查阅 SDK 存档。

    Flutter SDK 应下载到 macOS 默认下载目录：~/Downloads/。

  2. 创建一个你可以安装 Flutter 的文件夹。

    考虑在 ~/development/ 创建一个目录。

  3. 将文件解压到你希望存储 Flutter SDK 的目录中。

    unzip ~/Downloads/flutter_sdk_v1.0.0.zip \
       -d ~/development/

    完成后，Flutter SDK 应位于 ~/development/flutter 目录中。

将 Flutter 添加到您的 PATH

#

要在终端中运行 Flutter 命令，请将 Flutter 添加到 PATH 环境变量中。本指南假定你的 Mac 运行的是最新的默认 shell，即 zsh。Zsh 使用 .zshenv 文件来设置 环境变量。

  1. 启动您偏好的文本编辑器。

  2. 如果存在，请在您的文本编辑器中打开 Zsh 环境变量文件 ~/.zshenv。如果不存在，请创建 ~/.zshenv。

  3. 复制以下行并将其粘贴到您的 ~/.zshenv 文件末尾。

    bash
    export PATH=$HOME/development/flutter/bin:$PATH

  4. 保存您的 ~/.zshenv 文件。

  5. 要应用此更改，请重新启动所有打开的终端会话。

如果您使用其他 Shell，请查阅此关于设置 PATH 的教程。

检查开发环境设置

#

帮助

运行 Flutter doctor

#

flutter doctor 命令验证 macOS 完整 Flutter 开发环境的所有组件。

  1. 打开您的终端。

  2. 要验证所有组件的安装，请运行以下命令。

    flutter doctor

由于您选择为 Web 开发，因此您不需要所有组件。如果您遵循本指南，该命令应输出 [✓] 表示您已设置的工具和平台。

Flutter doctor 问题排查

#

当 flutter doctor 命令返回错误时，可能与 Flutter、VS Code、Xcode、已连接设备或网络资源有关。

如果 flutter doctor 命令针对这些组件中的任何一个返回错误，请使用详细模式标志再次运行它。

flutter doctor -v

检查输出，看是否需要安装其他软件或执行其他任务。

如果你更改了 Flutter SDK 或其相关组件的配置，请再次运行 flutter doctor 来验证安装。

使用 Flutter 在 macOS 上开始开发 Web 应用

#

恭喜。 已经安装了所有必需的先决条件和 Flutter SDK，您就可以在 macOS 上开始为 Web 开发 Flutter 应用了。

要继续你的学习之旅，请查阅以下指南：

管理 Flutter SDK

#

要了解更多关于管理 Flutter SDK 安装的信息，请查阅以下资源：

除非另有说明，否则本网站上的文档反映了 Flutter 的最新稳定版本。页面最后更新时间为 2025-09-05。 查看源代码 或 报告此页面问题。