:::warning
**Note for Intel Macs:**
Flutter is deprecating support for Intel-based Macs (x64).
Future Flutter releases will require Apple Silicon.
For details, check out the
[macOS Intel deprecation strategy](https://docs.google.com/document/d/1ty3js_Eg2sNIbDuyYS_aV7h4jYdx1hEpX_mV135gO4s/edit?tab=t.0#heading=h.cx7d8y57ce6p).
**关于 Intel Mac 的说明：**
Flutter 正在逐步停止对基于 Intel 的 Mac (x64) 的支持。
未来的 Flutter 版本将要求使用 Apple Silicon。
详情请查看
[macOS Intel 弃用策略](https://docs.google.com/document/d/1ty3js_Eg2sNIbDuyYS_aV7h4jYdx1hEpX_mV135gO4s/edit?tab=t.0#heading=h.cx7d8y57ce6p).
:::
1. Download the Flutter SDK bundle
下载 Flutter SDK bundle
To choose the correct bundle, you need to know your Mac's processor type. *(To check, go to **Apple menu () > About This Mac** and look at the **Processor** or **Chip** section.)* 你需要了解你的 Mac 处理器类型，来选择正确的软件包。 （前往 **Apple 菜单 () > 关于本机**， 并查看 **处理器** 或 **芯片** 部分。） Depending on your macOS device's cpu architecture, download one of the following installation bundles to get the latest stable release of the Flutter SDK. 根据你的 macOS 设备的 CPU 架构， 下载以下任一安装 bundle 以获取 Flutter SDK 的最新稳定版。 | Apple Silicon (ARM64) | Intel | | --------------------------------------------------------------------- | ------------------------------------------------------------------- | |Create a folder to store the SDK
创建用于存放 SDK 的文件夹
Create or find a folder to store the extracted SDK in. Consider creating and using a directory at `~/develop/`. 创建或找到一个用于存放解压后 SDK 的文件夹。 可考虑在 `~/develop/` 创建并使用该目录。 1.Extract the SDK
解压 SDK
Extract the SDK bundle you downloaded into the directory you want to store the Flutter SDK in. 将你下载的 SDK bundle 解压到 你希望存放 Flutter SDK 的目录。 1. Copy the following command. 复制以下命令。 1. Replace `Download the Flutter SDK bundle
下载 Flutter SDK bundle
Download the following installation bundle to get the latest stable release of the Flutter SDK. 下载以下安装 bundle 以获取 Flutter SDK 的最新稳定版。Create a folder to store the SDK
创建用于存放 SDK 的文件夹
Create or find a folder to store the extracted SDK in. Consider creating and using a directory at `~/develop/`. 创建或找到一个用于存放解压后 SDK 的文件夹。 可考虑在 `~/develop/` 创建并使用该目录。 1.Extract the SDK
解压 SDK
Extract the SDK bundle you downloaded into the directory you want to store the Flutter SDK in. 将你下载的 SDK bundle 解压到 你希望存放 Flutter SDK 的目录。 1. Copy the following command. 复制以下命令。 1. Replace `
1.
Determine your Flutter SDK installation location
确定 Flutter SDK 安装位置
Copy the absolute path to the directory that you downloaded and extracted the Flutter SDK into. 复制你下载并解压 Flutter SDK 所在目录的绝对路径。 1.Navigate to the environment variables settings
进入环境变量设置
1. Press Windows + Pause. 按下快捷键 Windows + Pause。 If your keyboard lacks a Pause key, try Windows + Fn + B. 如果你的键盘上没有 Pause 键， 请尝试 Windows + Fn + B。 The **System > About** dialog opens. 这将会显示 **系统 > 系统信息** 的窗口。 1. Click **Advanced System Settings** > **Advanced** > **Environment Variables...**. 单击 **高级系统设置** > **高级** > **环境变量…** The **Environment Variables** dialog opens. 这将会显示 **环境变量** 的窗口。 1.Add the Flutter SDK bin to your path
将 Flutter SDK 的 bin 添加到你的 PATH
1. In the **User variables for (username)** section of the **Environment Variables** dialog, look for the **Path** entry. 在 **环境变量** 对话框的 **（用户名）的用户变量** 区域中， 查找 **Path** 条目。 1. If the **Path** entry exists, double-click it. 若 **Path** 条目已存在，请双击它。 The **Edit Environment Variable** dialog should open. 此时应会打开 **编辑环境变量** 对话框。 1. Double-click inside an empty row. 双击空白行。 1. Type the path to the `bin` directory of your Flutter installation. 输入 Flutter 安装目录下 `bin` 的路径。 For example, if you downloaded Flutter into a `develop\flutter` folder inside your user directory, you'd type the following: 例如，若你将 Flutter 下载到用户目录下的 `develop\flutter` 文件夹，则应输入： ```plaintext %USERPROFILE%\develop\flutter\bin ``` 1. Click the Flutter entry you added to select it. 点击你添加的 Flutter 条目以将其选中。 1. Click **Move Up** until the Flutter entry sits at the top of the list. 点击 **上移**，直到 Flutter 条目位于列表顶部。 1. To confirm your changes, click **OK** three times. 要确认更改，请点击三次 **确定**。 {: type="a"} 1. If the entry doesn't exist, click **New...**. 若该条目不存在，请点击 **新建…**。 The **Edit Environment Variable** dialog should open. 此时应会打开 **编辑环境变量** 对话框。 1. In the **Variable Name** box, type `Path`. 在 **变量名** 框中输入 `Path`。 1. In the **Variable Value** box, type the path to the `bin` directory of your Flutter installation. 在 **变量值** 框中， 输入 Flutter 安装目录下 `bin` 的路径。 For example, if you downloaded Flutter into a `develop\flutter` folder inside your user directory, you'd type the following: 例如，若你将 Flutter 下载到用户目录下的 `develop\flutter` 文件夹，则应输入： ```plaintext %USERPROFILE%\develop\flutter\bin ``` 1. To confirm your changes, click **OK** three times. 要确认更改，请点击三次 **确定**。 {: type="a"} 1.Apply your changes
应用你的更改
To apply this change and get access to the `flutter` tool, close and reopen all open command prompts, sessions in your terminal apps, and IDEs. 要应用此更改并访问 `flutter` 工具， 请关闭并重新打开所有已打开的命令提示符、 终端应用中的会话以及 IDE。 1.Validate your setup
验证你的配置
To ensure you successfully added the SDK to your `PATH`, open command prompt or your preferred terminal app, then try running the `flutter` and `dart` tools. 为确保你已成功将 SDK 添加到 `PATH`， 请打开命令提示符或你偏好的终端应用， 然后尝试运行 `flutter` 和 `dart` 工具。 ```console $ flutter --version $ dart --version ``` If either command isn't found, check out [Flutter installation troubleshooting][troubleshoot]. 若任一命令未找到， 请参阅 [Flutter 安装问题排查][troubleshoot]。 {: .steps} [troubleshoot]: /install/troubleshoot
:::note
The following steps assume you're
using the [default shell][zsh-mac] on macOS, Zsh.
以下步骤假定你在 macOS 上使用
[默认 shell][zsh-mac] Zsh。
If you use another shell besides Zsh,
check out [this tutorial on setting your PATH][other-path].
若你使用的不是 Zsh，
请参阅 [这篇设置 PATH 的教程][other-path]。
:::
1. ` with the path to your Flutter SDK installation.
将 `` 替换为你的 Flutter SDK 安装路径。
```bash
export PATH="/bin:$PATH"
```
For example, if you downloaded Flutter into a
`develop/flutter` folder inside your user directory,
you'd add the following to the file:
例如，若你将 Flutter 下载到用户目录下的
`develop/flutter` 文件夹，可向文件添加：
```bash
export PATH="$HOME/develop/flutter/bin:$PATH"
```
1.
Determine your Flutter SDK installation location
确定 Flutter SDK 安装位置
Copy the absolute path to the directory that you downloaded and extracted the Flutter SDK into. 复制你下载并解压 Flutter SDK 所在目录的绝对路径。 1.Open or create the Zsh environment variable file
打开或创建 Zsh 环境变量文件
If it exists, open the [Zsh environment variable file][zsh-files] `~/.zprofile` in your preferred text editor. If it doesn't exist, create the `~/.zprofile` file. 若存在，请在你偏好的文本编辑器中打开 [Zsh 环境变量文件][zsh-files] `~/.zprofile`。 若不存在，请创建 `~/.zprofile` 文件。 1.Add the Flutter SDK bin to your path
将 Flutter SDK 的 bin 添加到你的 PATH
At the end of your `~/.zprofile` file, use the built-in `export` command to update the `PATH` variable to include the `bin` directory of your Flutter installation. 在 `~/.zprofile` 文件末尾， 使用内置 `export` 命令更新 `PATH` 变量， 使其包含 Flutter 安装目录下的 `bin`。 Replace `Save your changes
保存你的更改
Save, then close, the `~/.zprofile` file you edited. 保存并关闭你编辑的 `~/.zprofile` 文件。 1.Apply your changes
应用你的更改
To apply this change and get access to the `flutter` tool, close and reopen all open Zsh sessions in your terminal apps and IDEs. 要应用此更改并访问 `flutter` 工具， 请在终端应用和 IDE 中关闭并重新打开所有已打开的 Zsh 会话。 1.Validate your setup
验证你的配置
To ensure you successfully added the SDK to your `PATH`, open a Zsh session in your preferred terminal, then try running the `flutter` and `dart` tools. 为确保你已成功将 SDK 添加到 `PATH`， 请在你偏好的终端中打开 Zsh 会话， 然后尝试运行 `flutter` 和 `dart` 工具。 ```console $ flutter --version $ dart --version ``` If either command isn't found, check out [Flutter installation troubleshooting][troubleshoot]. 若任一命令未找到， 请参阅 [Flutter 安装问题排查][troubleshoot]。 {: .steps} [zsh-mac]: https://support.apple.com/en-us/102360 [zsh-files]: https://zsh.sourceforge.io/Intro/intro_3.html [other-path]: https://www.cyberciti.biz/faq/unix-linux-adding-path/ [troubleshoot]: /install/troubleshoot
1. ` with the path to your Flutter SDK install.
将 `` 替换为你的 Flutter SDK 安装路径。
1. Run the edited command in your preferred terminal with that shell.
在使用该 shell 的你偏好的终端中运行编辑后的命令。
展开
```console
$ echo 'export PATH="/bin:$PATH"' >> ~/.bashrc
```
For example, if you downloaded Flutter into a
`develop/flutter` folder inside your user directory,
you'd run the following:
例如，若你将 Flutter 下载到用户目录下的
`develop/flutter` 文件夹，可运行：
```console
$ echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.bashrc
```
展开
```console
$ echo 'export PATH="/bin:$PATH"' >> ~/.zshenv
```
For example, if you downloaded Flutter into a
`develop/flutter` folder inside your user directory,
you'd run the following:
例如，若你将 Flutter 下载到用户目录下的
`develop/flutter` 文件夹，可运行：
```console
$ echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.zshenv
```
展开
```console
$ fish_add_path -g -p /bin
```
For example, if you downloaded Flutter into a
`develop/flutter` folder inside your user directory,
you'd run the following:
例如，若你将 Flutter 下载到用户目录下的
`develop/flutter` 文件夹，可运行：
```console
$ fish_add_path -g -p ~/develop/flutter/bin
```
展开
```console
$ echo 'setenv PATH "/bin:$PATH"' >> ~/.cshrc
```
For example, if you downloaded Flutter into a
`develop/flutter` folder inside your user directory,
you'd run the following:
例如，若你将 Flutter 下载到用户目录下的
`develop/flutter` 文件夹，可运行：
```console
$ echo 'setenv PATH "$HOME/develop/flutter/bin:$PATH"' >> ~/.cshrc
```
展开
```console
$ echo 'setenv PATH "/bin:$PATH"' >> ~/.tcshrc
```
For example, if you downloaded Flutter into a
`develop/flutter` folder inside your user directory,
you'd run the following:
例如，若你将 Flutter 下载到用户目录下的
`develop/flutter` 文件夹，可运行：
```console
$ echo 'setenv PATH "$HOME/develop/flutter/bin:$PATH"' >> ~/.tcshrc
```
展开
```console
$ echo 'export PATH="/bin:$PATH"' >> ~/.profile
```
For example, if you downloaded Flutter into a
`develop/flutter` folder inside your user directory,
you'd run the following:
例如，若你将 Flutter 下载到用户目录下的
`develop/flutter` 文件夹，可运行：
```console
$ echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.profile
```
展开
```console
$ echo 'export PATH="/bin:$PATH"' >> ~/.profile
```
For example, if you downloaded Flutter into a
`develop/flutter` folder inside your user directory,
you'd run the following:
例如，若你将 Flutter 下载到用户目录下的
`develop/flutter` 文件夹，可运行：
```console
$ echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.profile
```
1.
Determine your Flutter SDK installation location
确定 Flutter SDK 安装位置
Copy the absolute path to the directory that you downloaded and extracted the Flutter SDK into. 复制你下载并解压 Flutter SDK 所在目录的绝对路径。 1.Determine your default shell
确定你的默认 shell
If you don't know what shell you use, check which shell starts when you open a new console window. 若你不确定自己使用哪种 shell， 可查看打开新控制台窗口时启动的是哪一种。 ```console $ echo $SHELL ``` 1.Add the Flutter SDK bin to your path
将 Flutter SDK 的 bin 添加到你的 PATH
To add the `bin` directory of your Flutter installation to your `PATH`: 要将 Flutter 安装目录下的 `bin` 添加到 `PATH`： 1. Expand the instructions for your default shell. 展开与你默认 shell 对应的说明。 1. Copy the provided command. 复制提供的命令。 1. Replace `展开 bash 相关说明
```console
$ echo 'export PATH="展开 zsh 相关说明
```console
$ echo 'export PATH="展开 fish 相关说明
```console
$ fish_add_path -g -p 展开 csh 相关说明
```console
$ echo 'setenv PATH "展开 tcsh 相关说明
```console
$ echo 'setenv PATH "展开 ksh 相关说明
```console
$ echo 'export PATH="展开 sh 相关说明
```console
$ echo 'export PATH="Apply your changes
应用你的更改
To apply this change and get access to the `flutter` tool, close and reopen all open shell sessions in your terminal apps and IDEs. 要应用此更改并访问 `flutter` 工具， 请在终端应用和 IDE 中关闭并重新打开所有已打开的 shell 会话。 1.Validate your setup
验证你的配置
To ensure you successfully added the SDK to your `PATH`, open your preferred terminal with your default shell, then try running the `flutter` and `dart` tools. 为确保你已成功将 SDK 添加到 `PATH`， 请使用默认 shell 打开你偏好的终端， 然后尝试运行 `flutter` 和 `dart` 工具。 ```console $ flutter --version $ dart --version ``` If either command isn't found, check out [Flutter installation troubleshooting][troubleshoot]. 若任一命令未找到， 请参阅 [Flutter 安装问题排查][troubleshoot]。 {: .steps} [troubleshoot]: /install/troubleshoot
:::note
The following steps assume
you've already [turned on Linux support][chromeos-linux] and that
you're using Bash or the default shell on ChromeOS.
以下步骤假定
你已 [开启 Linux 支持][chromeos-linux]，并且
你使用的是 ChromeOS 上的 Bash 或默认 shell。
If you're using a different shell besides the default or Bash, follow the
[add to path instructions for Linux][linux-path]{: target="_blank"} instead.
若你使用的不是默认 shell 或 Bash，请改为按照
[Linux 的添加到 PATH 说明][linux-path]{: target="_blank"} 操作。
:::
1. ` with the path to your Flutter SDK install.
将 `` 替换为你的 Flutter SDK 安装路径。
1. Run the edited command in your preferred terminal.
在你偏好的终端中运行编辑后的命令。
```console
$ echo 'export PATH=":$PATH"' >> ~/.bash_profile
```
For example, if you downloaded Flutter into a
`develop/flutter` folder inside your user directory,
you'd run the following:
例如，若你将 Flutter 下载到用户目录下的
`develop/flutter` 文件夹，可运行：
```console
$ echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.bash_profile
```
1.
## Continue your Flutter journey {: #next-steps}
## 继续你的 Flutter 之旅
Now that you've successfully installed Flutter,
set up development for at least one target platform
to continue your journey with Flutter.
现在你已经成功安装了 Flutter，
请至少为一个目标平台配置开发环境，
以继续你的 Flutter 学习之旅。
:::recommend
If you don't yet have a preferred platform
to target during development,
the Flutter team recommends you first try out
[developing on the web][web-setup]!
若你尚未确定开发时要面向的平台，
Flutter 团队建议你首先尝试
[在 Web 上开发][web-setup]！
:::
[web-setup]: /platform-integration/web/setup
