手动安装 Flutter
了解如何手动安装并配置 Flutter SDK。
了解如何手动安装并配置你的 Flutter 开发环境。
选择你的开发平台
#本页说明默认针对在 Windows 设备上安装 Flutter。
若要查看其他操作系统的说明,请选择以下选项之一。
下载必备软件
#在安装 Flutter SDK 之前,请先完成以下配置。
-
为 Windows 安装 Git
下载并安装最新版本的 Git for Windows。
有关安装或排查 Git 问题的帮助,请参阅 Git 文档。
-
配置编辑器或 IDE
为获得最佳的 Flutter 应用开发体验,请考虑安装并配置 支持 Flutter 的编辑器或 IDE。
-
安装 Xcode 命令行工具
下载 Xcode 命令行工具以获取 Flutter 依赖的命令行工具(包括 Git)。
要下载这些工具,请在你偏好的终端中运行以下命令:
xcode-select --install若你尚未安装这些工具,应会弹出对话框确认你是否要安装。点击 Install,安装完成后点击 Done。
-
配置编辑器或 IDE
为获得最佳的 Flutter 应用开发体验,请考虑安装并配置 支持 Flutter 的编辑器或 IDE。
-
下载并安装必备 package
使用你偏好的 package 管理器或安装方式,安装以下 package 的最新版本:
curlgitunzipxz-utilsziplibglu1-mesa
在基于 Debian 且使用
apt-get的发行版(例如 Ubuntu)上,请使用以下命令安装这些 package: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 相关问题 的说明确保其为最新状态。
-
下载并安装必备 package
使用
apt-get或你偏好的安装方式,安装以下 package 的最新版本:curlgitunzipxz-utilsziplibglu1-mesa
若要使用
apt-get,请使用以下命令安装这些 package: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 归档下载最新 bundle,然后将其解压到你希望存放的位置。
-
下载 Flutter SDK bundle
下载以下安装 bundle 以获取 Flutter SDK 的最新稳定版。
(加载中...) -
创建用于存放 SDK 的文件夹
创建或找到一个用于存放解压后 SDK 的文件夹。可考虑在
%USERPROFILE%\develop(C:\Users\{username}\develop)创建并使用该目录。 -
解压 SDK
将你下载的 SDK bundle 解压到你希望存放 Flutter SDK 的目录。
复制以下命令。
将
<sdk_zip_path>替换为你下载的 bundle 路径。将
<destination_directory_path>替换为你希望存放解压后 SDK 的文件夹路径。在你偏好的终端中运行编辑后的命令。
Expand-Archive –Path <sdk_zip_path> -Destination <destination_directory_path>例如,若你将 Flutter 3.29.3 的 bundle 下载到
%USERPROFILE%\Downloads目录,并希望将解压后的 SDK 存放在%USERPROFILE%\develop目录:Expand-Archive ` -Path $env:USERPROFILE\Downloads\flutter_windows_3.29.3-stable.zip ` -Destination $env:USERPROFILE\develop\
-
下载 Flutter SDK bundle
根据你的 macOS 设备的 CPU 架构,下载以下任一安装 bundle 以获取 Flutter SDK 的最新稳定版。
-
创建用于存放 SDK 的文件夹
创建或找到一个用于存放解压后 SDK 的文件夹。可考虑在
~/develop/创建并使用该目录。 -
解压 SDK
将你下载的 SDK bundle 解压到你希望存放 Flutter SDK 的目录。
复制以下命令。
将
<sdk_zip_path>替换为你下载的 bundle 路径。将
<destination_directory_path>替换为你希望存放解压后 SDK 的文件夹路径。在你偏好的终端中运行编辑后的命令。
unzip <sdk_zip_path> -d <destination_directory_path>例如,若你将 Flutter 3.29.3 的 bundle 下载到
~/Downloads目录,并希望将解压后的 SDK 存放在~/develop目录:unzip ~/Downloads/flutter_macos_3.29.3-stable.zip -d ~/develop/
-
下载 Flutter SDK bundle
下载以下安装 bundle 以获取 Flutter SDK 的最新稳定版。
(加载中...) -
创建用于存放 SDK 的文件夹
创建或找到一个用于存放解压后 SDK 的文件夹。可考虑在
~/develop/创建并使用该目录。 -
解压 SDK
将你下载的 SDK bundle 解压到你希望存放 Flutter SDK 的目录。
复制以下命令。
将
<sdk_zip_path>替换为你下载的 bundle 路径。将
<destination_directory_path>替换为你希望存放解压后 SDK 的文件夹路径。在你偏好的终端中运行编辑后的命令。
tar -xf <sdk_zip_path> -C <destination_directory_path>例如,若你将 Flutter 3.29.3 的 bundle 下载到
~/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 添加到你的 PATH
在 环境变量 对话框的 (用户名)的用户变量 区域中,查找 Path 条目。
若 Path 条目已存在,请双击它。
此时应会打开 编辑环境变量 对话框。
双击空白行。
输入 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 环境变量文件
~/.zprofile。若不存在,请创建~/.zprofile文件。 -
将 Flutter SDK 的 bin 添加到你的 PATH
在
~/.zprofile文件末尾,使用内置export命令更新PATH变量,使其包含 Flutter 安装目录下的bin。将
<path-to-sdk>替换为你的 Flutter SDK 安装路径。bashexport PATH="<path-to-sdk>/bin:$PATH"例如,若你将 Flutter 下载到用户目录下的
develop/flutter文件夹,可向文件添加:bashexport PATH="$HOME/develop/flutter/bin:$PATH" -
保存你的更改
保存并关闭你编辑的
~/.zprofile文件。 -
应用你的更改
要应用此更改并访问
flutter工具,请在终端应用和 IDE 中关闭并重新打开所有已打开的 Zsh 会话。 -
验证你的配置
为确保你已成功将 SDK 添加到
PATH,请在你偏好的终端中打开 Zsh 会话,然后尝试运行flutter和dart工具。flutter --version dart --version若任一命令未找到,请参阅 Flutter 安装问题排查。
-
确定 Flutter SDK 安装位置
复制你下载并解压 Flutter SDK 所在目录的绝对路径。
-
确定你的默认 shell
若你不确定自己使用哪种 shell,可查看打开新控制台窗口时启动的是哪一种。
echo $SHELL -
将 Flutter SDK 的 bin 添加到你的 PATH
要将 Flutter 安装目录下的
bin添加到PATH:展开与你默认 shell 对应的说明。
复制提供的命令。
将
<path-to-sdk>替换为你的 Flutter SDK 安装路径。在使用该 shell 的你偏好的终端中运行编辑后的命令。
展开
bash相关说明echo 'export PATH="<path-to-sdk>/bin:$PATH"' >> ~/.bashrc例如,若你将 Flutter 下载到用户目录下的
develop/flutter文件夹,可运行:echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.bashrc展开
zsh相关说明echo 'export PATH="<path-to-sdk>/bin:$PATH"' >> ~/.zshenv例如,若你将 Flutter 下载到用户目录下的
develop/flutter文件夹,可运行:echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.zshenv展开
fish相关说明fish_add_path -g -p <path-to-sdk>/bin例如,若你将 Flutter 下载到用户目录下的
develop/flutter文件夹,可运行:fish_add_path -g -p ~/develop/flutter/bin展开
csh相关说明echo 'setenv PATH "<path-to-sdk>/bin:$PATH"' >> ~/.cshrc例如,若你将 Flutter 下载到用户目录下的
develop/flutter文件夹,可运行:echo 'setenv PATH "$HOME/develop/flutter/bin:$PATH"' >> ~/.cshrc展开
tcsh相关说明echo 'setenv PATH "<path-to-sdk>/bin:$PATH"' >> ~/.tcshrc例如,若你将 Flutter 下载到用户目录下的
develop/flutter文件夹,可运行:echo 'setenv PATH "$HOME/develop/flutter/bin:$PATH"' >> ~/.tcshrc展开
ksh相关说明echo 'export PATH="<path-to-sdk>/bin:$PATH"' >> ~/.profile例如,若你将 Flutter 下载到用户目录下的
develop/flutter文件夹,可运行:echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.profile展开
sh相关说明echo 'export PATH="<path-to-sdk>/bin:$PATH"' >> ~/.profile例如,若你将 Flutter 下载到用户目录下的
develop/flutter文件夹,可运行:echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.profile -
应用你的更改
要应用此更改并访问
flutter工具,请在终端应用和 IDE 中关闭并重新打开所有已打开的 shell 会话。 -
验证你的配置
为确保你已成功将 SDK 添加到
PATH,请使用默认 shell 打开你偏好的终端,然后尝试运行flutter和dart工具。flutter --version dart --version若任一命令未找到,请参阅 Flutter 安装问题排查。
-
确定 Flutter SDK 安装位置
复制你下载并解压 Flutter SDK 所在目录的绝对路径。
-
将 Flutter SDK 的 bin 添加到你的 PATH
要将 Flutter 安装目录下的
bin添加到PATH:复制以下命令。
将
<path-to-sdk>替换为你的 Flutter SDK 安装路径。在你偏好的终端中运行编辑后的命令。
echo 'export PATH="<path-to-sdk>:$PATH"' >> ~/.bash_profile例如,若你将 Flutter 下载到用户目录下的
develop/flutter文件夹,可运行:echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.bash_profile -
应用你的更改
要应用此更改并访问
flutter工具,请在终端应用和 IDE 中关闭并重新打开所有已打开的 Zsh 会话。 -
验证你的配置
为确保你已成功将 SDK 添加到
PATH,请在你偏好的终端中打开 Zsh 会话,然后尝试运行flutter和dart工具。flutter --version dart --version若任一命令未找到,请参阅 Flutter 安装问题排查。
继续你的 Flutter 之旅
#现在你已经成功安装了 Flutter,请至少为一个目标平台配置开发环境,以继续你的 Flutter 学习之旅。
除非另有说明,本文档之所提及适用于 Flutter 3.44.0 版本。本页面最后更新时间:2026-06-14。查看文档源码 或者 为本页面内容提出建议。