手动安装 Flutter
了解如何安装和手动设置您的 Flutter 开发环境。
选择您的开发平台
#本页说明旨在涵盖在 Windows 设备上安装 Flutter 的过程。
如果您想遵循适用于不同操作系统的说明,请选择以下一项。
下载先决软件
#在安装 Flutter SDK 之前,请先完成以下设置。
安装适用于 Windows 的 Git
下载并安装最新版适用于 Windows 的 Git。
如需安装或排查 Git 的帮助,请参考Git 文档。
设置编辑器或 IDE
为获得最佳的 Flutter 应用开发体验,请考虑安装并设置支持 Flutter 的编辑器或 IDE。
安装 Xcode 命令行工具
下载 Xcode 命令行工具,以获取 Flutter 依赖的命令行工具,包括 Git。
要下载这些工具,请在您偏好的终端中运行以下命令
xcode-select --install
如果您尚未安装这些工具,将弹出一个对话框,确认您是否要安装它们。点击安装,待安装完成后,点击完成。
设置编辑器或 IDE
为获得最佳的 Flutter 应用开发体验,请考虑安装并设置支持 Flutter 的编辑器或 IDE。
下载并安装必备软件包
使用您偏好的软件包管理器或机制,安装以下软件包的最新版本
curl
git
unzip
xz-utils
zip
libglu1-mesa
在基于 Debian 的发行版(如 Ubuntu)上,使用
apt-get
通过以下命令安装这些软件包sudo apt-get update -y && sudo apt-get upgrade -y sudo apt-get install -y curl git unzip xz-utils zip libglu1-mesa
设置编辑器或 IDE
为获得最佳的 Flutter 应用开发体验,请考虑安装并设置支持 Flutter 的编辑器或 IDE。
设置 Linux 支持
如果您之前未在 Chromebook 上设置过 Linux 支持,请开启 Linux 支持。
如果您已经开启了 Linux 支持,请按照修复 Linux 问题的说明,确保其为最新状态。
下载并安装必备软件包
使用
apt-get
或您偏好的安装机制,安装以下软件包的最新版本curl
git
unzip
xz-utils
zip
libglu1-mesa
如果您想使用
apt-get
,请使用以下命令安装这些软件包sudo apt-get update -y && sudo apt-get upgrade -y sudo apt-get install -y curl git unzip xz-utils zip libglu1-mesa
设置编辑器或 IDE
为获得最佳的 Flutter 应用开发体验,请考虑安装并设置支持 Flutter 的编辑器或 IDE。
安装并设置 Flutter
#要安装 Flutter SDK,请从 SDK 存档下载最新捆绑包,然后将 SDK 解压到您希望存储的位置。
下载 Flutter SDK 捆绑包
下载以下安装包以获取 Flutter SDK 的最新稳定版本。
创建用于存储 SDK 的文件夹
创建或找到一个用于存储解压后的 SDK 的文件夹。考虑在
%USERPROFILE%\develop
(C:\Users\{username}\develop
) 下创建并使用一个目录。解压 SDK
将您下载的 SDK 捆绑包解压到您希望存储 Flutter SDK 的目录中。
- 复制以下命令。
- 将
<sdk_zip_path>
替换为您下载的捆绑包路径。 - 将
<destination_directory_path>
替换为存放解压后的 SDK 的文件夹路径。 - 在您偏好的终端中运行编辑后的命令。
Expand-Archive –Path <sdk_zip_path> -Destination <destination_directory_path>
例如,如果您将 Flutter 3.29.3 的捆绑包下载到
%USERPROFILE%\Downloads
目录,并希望将解压后的 SDK 存储在%USERPROFILE%\develop
目录中Expand-Archive ` –Path $env:USERPROFILE\Downloads\flutter_windows_3.29.3-stable.zip ` -Destination $env:USERPROFILE\develop\
下载 Flutter SDK 捆绑包
根据您的 macOS 设备的 CPU 架构,下载以下安装捆绑包之一以获取 Flutter SDK 的最新稳定版本。
创建用于存储 SDK 的文件夹
创建或找到一个用于存储解压后的 SDK 的文件夹。考虑在
~/develop/
下创建并使用一个目录。解压 SDK
将您下载的 SDK 捆绑包解压到您希望存储 Flutter SDK 的目录中。
- 复制以下命令。
- 将
<sdk_zip_path>
替换为您下载的捆绑包路径。 - 将
<destination_directory_path>
替换为存放解压后的 SDK 的文件夹路径。 - 在您偏好的终端中运行编辑后的命令。
unzip <sdk_zip_path> -d <destination_directory_path>
例如,如果您将 Flutter 3.29.3 的捆绑包下载到
~/Downloads
目录,并希望将解压后的 SDK 存储在~/develop
目录中unzip ~/Downloads/flutter_macos_3.29.3-stable.zip -d ~/develop/
下载 Flutter SDK 捆绑包
下载以下安装包以获取 Flutter SDK 的最新稳定版本。
创建用于存储 SDK 的文件夹
创建或找到一个用于存储解压后的 SDK 的文件夹。考虑在
~/develop/
下创建并使用一个目录。解压 SDK
将您下载的 SDK 捆绑包解压到您希望存储 Flutter SDK 的目录中。
- 复制以下命令。
- 将
<sdk_zip_path>
替换为您下载的捆绑包路径。 - 将
<destination_directory_path>
替换为存放解压后的 SDK 的文件夹路径。 - 在您偏好的终端中运行编辑后的命令。
tar -xf <sdk_zip_path> -C <destination_directory_path>
例如,如果您将 Flutter 3.29.3 的捆绑包下载到
~/Downloads
目录,并希望将解压后的 SDK 存储在~/develop
目录中tar -xf ~/Downloads/flutter_linux_3.29.3-stable.tar.xz -C ~/develop/
将 Flutter 添加到 PATH
#现在您已经下载了 SDK,请将 Flutter SDK 的 bin
目录添加到您的 PATH
环境变量中。将 Flutter 添加到 PATH
允许您在终端和 IDE 中使用 flutter
和 dart
命令行工具。
确定您的 Flutter SDK 安装位置
复制您下载并解压 Flutter SDK 的目录的绝对路径。
导航到环境变量设置
按下 Windows + Pause。
如果您的键盘没有 Pause 键,请尝试 Windows + Fn + B。
系统 > 关于 对话框打开。
点击高级系统设置 > 高级 > 环境变量...。
环境变量 对话框打开。
将 Flutter SDK 的 bin 目录添加到您的路径
在环境变量对话框的用户变量 (username) 部分,查找路径条目。
如果路径条目存在,双击它。
编辑环境变量 对话框应该打开。
双击空白行。
输入您的 Flutter 安装目录中
bin
目录的路径。例如,如果您将 Flutter 下载到用户目录中的
develop\flutter
文件夹,您将输入以下内容%USERPROFILE%\develop\flutter\bin
点击您添加的 Flutter 条目以选中它。
点击上移,直到 Flutter 条目位于列表顶部。
要确认您的更改,请点击三次确定。
如果该条目不存在,请点击新建...。
编辑环境变量 对话框应该打开。
在“变量名”框中,输入
Path
。在变量值框中,输入您的 Flutter 安装目录中
bin
目录的路径。例如,如果您将 Flutter 下载到用户目录中的
develop\flutter
文件夹,您将输入以下内容%USERPROFILE%\develop\flutter\bin
要确认您的更改,请点击三次确定。
应用您的更改
要应用此更改并访问
flutter
工具,请关闭并重新打开所有打开的命令提示符、终端应用程序中的会话以及 IDE。验证您的设置
为确保您已成功将 SDK 添加到
PATH
,请打开命令提示符或您偏好的终端应用程序,然后尝试运行flutter
和dart
工具。flutter --version dart --version
如果任何命令未找到,请查看Flutter 安装故障排除。
确定您的 Flutter SDK 安装位置
复制您下载并解压 Flutter SDK 的目录的绝对路径。
打开或创建 Zsh 环境变量文件
如果存在,请在您偏好的文本编辑器中打开 Zsh 环境变量文件
~/.zshenv
。如果不存在,请创建~/.zshenv
文件。将 Flutter SDK 的 bin 目录添加到您的路径
在您的
~/.zshenv
文件末尾,使用内置的export
命令更新PATH
变量,以包含您的 Flutter 安装目录中的bin
目录。将
<path-to-sdk>
替换为您的 Flutter SDK 安装路径。bashexport PATH="<path-to-sdk>/bin:$PATH"
例如,如果您将 Flutter 下载到用户目录中的
development/flutter
文件夹,您将把以下内容添加到文件中bashexport PATH="$HOME/development/flutter/bin:$PATH"
保存您的更改
保存并关闭您编辑的
~/.zshenv
文件。应用您的更改
要应用此更改并访问
flutter
工具,请关闭并重新打开您的终端应用程序和 IDE 中所有打开的 Zsh 会话。验证您的设置
为确保您已成功将 SDK 添加到
PATH
,请在您偏好的终端中打开 Zsh 会话,然后尝试运行flutter
和dart
工具。flutter --version dart --version
如果任何命令未找到,请查看Flutter 安装故障排除。
确定您的 Flutter SDK 安装位置
复制您下载并解压 Flutter SDK 的目录的绝对路径。
确定您的默认 shell
如果您不知道使用哪个 shell,请在新控制台窗口打开时检查哪个 shell 启动。
echo $SHELL
将 Flutter SDK 的 bin 目录添加到您的路径
要将您的 Flutter 安装目录中的
bin
目录添加到您的PATH
- 展开您默认 shell 的说明。
- 复制提供的命令。
- 将
<path-to-sdk>
替换为您的 Flutter SDK 安装路径。 - 在该 shell 中运行您偏好的终端中编辑后的命令。
展开
bash
说明echo 'export PATH="<path-to-sdk>:$PATH"' >> ~/.bash_profile
例如,如果您将 Flutter 下载到用户目录中的
development/flutter
文件夹,您将运行以下内容echo 'export PATH="$HOME/development/flutter/bin:$PATH"' >> ~/.bash_profile
展开
zsh
说明echo 'export PATH="<path-to-sdk>/bin:$PATH"' >> ~/.zshenv
例如,如果您将 Flutter 下载到用户目录中的
development/flutter
文件夹,您将运行以下内容echo 'export PATH="$HOME/development/flutter/bin:$PATH"' >> ~/.zshenv
展开
fish
说明fish_add_path -g -p <path-to-sdk>/bin
例如,如果您将 Flutter 下载到用户目录中的
development/flutter
文件夹,您将运行以下内容fish_add_path -g -p ~/development/flutter/bin
展开
csh
说明echo 'setenv PATH "<path-to-sdk>/bin:$PATH"' >> ~/.cshrc
例如,如果您将 Flutter 下载到用户目录中的
development/flutter
文件夹,您将运行以下内容echo 'setenv PATH "$HOME/development/flutter/bin:$PATH"' >> ~/.cshrc
展开
tcsh
说明echo 'setenv PATH "<path-to-sdk>/bin:$PATH"' >> ~/.tcshrc
例如,如果您将 Flutter 下载到用户目录中的
development/flutter
文件夹,您将运行以下内容echo 'setenv PATH "$HOME/development/flutter/bin:$PATH"' >> ~/.tcshrc
展开
ksh
说明echo 'export PATH="<path-to-sdk>/bin:$PATH"' >> ~/.profile
例如,如果您将 Flutter 下载到用户目录中的
development/flutter
文件夹,您将运行以下内容echo 'export PATH="$HOME/development/flutter/bin:$PATH"' >> ~/.profile
展开
sh
说明echo 'export PATH="<path-to-sdk>/bin:$PATH"' >> ~/.profile
例如,如果您将 Flutter 下载到用户目录中的
development/flutter
文件夹,您将运行以下内容echo 'export PATH="$HOME/development/flutter/bin:$PATH"' >> ~/.profile
应用您的更改
要应用此更改并访问
flutter
工具,请关闭并重新打开您的终端应用程序和 IDE 中所有打开的 shell 会话。验证您的设置
为确保您已成功将 SDK 添加到
PATH
,请使用您的默认 shell 打开您偏好的终端,然后尝试运行flutter
和dart
工具。flutter --version dart --version
如果任何命令未找到,请查看Flutter 安装故障排除。
确定您的 Flutter SDK 安装位置
复制您下载并解压 Flutter SDK 的目录的绝对路径。
将 Flutter SDK 的 bin 目录添加到您的路径
要将您的 Flutter 安装目录中的
bin
目录添加到您的PATH
- 复制以下命令。
- 将
<path-to-sdk>
替换为您的 Flutter SDK 安装路径。 - 在您偏好的终端中运行编辑后的命令。
echo 'export PATH="<path-to-sdk>:$PATH"' >> ~/.bash_profile
例如,如果您将 Flutter 下载到用户目录中的
development/flutter
文件夹,您将运行以下内容echo 'export PATH="$HOME/development/flutter/bin:$PATH"' >> ~/.bash_profile
应用您的更改
要应用此更改并访问
flutter
工具,请关闭并重新打开您的终端应用程序和 IDE 中所有打开的 Zsh 会话。验证您的设置
为确保您已成功将 SDK 添加到
PATH
,请在您偏好的终端中打开 Zsh 会话,然后尝试运行flutter
和dart
工具。flutter --version dart --version
如果任何命令未找到,请查看Flutter 安装故障排除。
继续您的 Flutter 之旅
#现在您已成功安装 Flutter,请为至少一个目标平台设置开发环境,以继续您的 Flutter 之旅。