将 Flutter 添加到 PATH
了解在下载 Flutter SDK 后如何将 Flutter 添加到你的 PATH。
了解如何在下载 SDK 后将 Flutter 添加到你的 PATH 环境变量。将 Flutter 添加到你的 PATH 后,你就可以在终端和 IDE 中使用
flutter 和 dart 命令行工具。
在 Windows 上将 Flutter 添加到你的 `PATH`。
在 macOS 上将 Flutter 添加到你的 `PATH`。
在 Linux 上将 Flutter 添加到你的 `PATH`。
在 ChromeOS 上将 Flutter 添加到你的 `PATH`。
Windows
#
要在 Windows 终端中运行 flutter 和 dart 命令,请将 Flutter SDK 的 bin 目录添加到 Path 环境变量。
-
确定 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 安装问题排查。
macOS
#
要在 macOS 终端中运行 flutter 和 dart 命令,请将 Flutter SDK 的 bin 目录添加到 PATH 环境变量。
-
确定 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 安装问题排查。
Linux
#Linux
#
要在 Linux 终端中运行 flutter 和 dart 命令,请将 Flutter SDK 的 bin 目录添加到 PATH 环境变量。
-
确定 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 安装问题排查。
ChromeOS
#
要在 ChromeOS 终端中运行 flutter 和 dart 命令,请将 Flutter SDK 的 bin 目录添加到 PATH 环境变量。
-
确定 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 3.44.0 版本。本页面最后更新时间:2026-06-14。查看文档源码 或者 为本页面内容提出建议。