跳转至正文

将 Flutter 添加到 PATH

了解在下载 Flutter SDK 后如何将 Flutter 添加到你的 PATH。

了解如何在下载 SDK 后将 Flutter 添加到你的 PATH 环境变量。将 Flutter 添加到你的 PATH 后,你就可以在终端和 IDE 中使用 flutter 和 dart 命令行工具。

Windows

#

要在 Windows 终端中运行 flutter 和 dart 命令,请将 Flutter SDK 的 bin 目录添加到 Path 环境变量。

  1. 确定 Flutter SDK 安装位置

    复制你下载并解压 Flutter SDK 所在目录的绝对路径。

    1. 按下快捷键 Windows + Pause。

      如果你的键盘上没有 Pause 键,请尝试 Windows + Fn + B。

      这将会显示 系统 > 系统信息 的窗口。

    2. 单击 高级系统设置 > 高级 > 环境变量…

      这将会显示 环境变量 的窗口。

  2. 将 Flutter SDK 的 bin 添加到你的 PATH

    1. 在 环境变量 对话框的 (用户名)的用户变量 区域中,查找 Path 条目。

    2. 若 Path 条目已存在,请双击它。

      此时应会打开 编辑环境变量 对话框。

      1. 双击空白行。

      2. 输入 Flutter 安装目录下 bin 的路径。

        例如,若你将 Flutter 下载到用户目录下的 develop\flutter 文件夹,则应输入:

        %USERPROFILE%\develop\flutter\bin
        
      3. 点击你添加的 Flutter 条目以将其选中。

      4. 点击 上移,直到 Flutter 条目位于列表顶部。

      5. 要确认更改,请点击三次 确定。

    3. 若该条目不存在,请点击 新建…。

      此时应会打开 编辑环境变量 对话框。

      1. 在 变量名 框中输入 Path。

      2. 在 变量值 框中,输入 Flutter 安装目录下 bin 的路径。

        例如,若你将 Flutter 下载到用户目录下的 develop\flutter 文件夹,则应输入:

        %USERPROFILE%\develop\flutter\bin
        
      3. 要确认更改,请点击三次 确定。

  3. 应用你的更改

    要应用此更改并访问 flutter 工具,请关闭并重新打开所有已打开的命令提示符、终端应用中的会话以及 IDE。

  4. 验证你的配置

    为确保你已成功将 SDK 添加到 PATH,请打开命令提示符或你偏好的终端应用,然后尝试运行 flutter 和 dart 工具。

    flutter --version
    dart --version
    

    若任一命令未找到,请参阅 Flutter 安装问题排查。

macOS

#

要在 macOS 终端中运行 flutter 和 dart 命令,请将 Flutter SDK 的 bin 目录添加到 PATH 环境变量。

  1. 确定 Flutter SDK 安装位置

    复制你下载并解压 Flutter SDK 所在目录的绝对路径。

  2. 打开或创建 Zsh 环境变量文件

    若存在,请在你偏好的文本编辑器中打开 Zsh 环境变量文件 ~/.zprofile。若不存在,请创建 ~/.zprofile 文件。

  3. 将 Flutter SDK 的 bin 添加到你的 PATH

    在 ~/.zprofile 文件末尾,使用内置 export 命令更新 PATH 变量,使其包含 Flutter 安装目录下的 bin。

    将 <path-to-sdk> 替换为你的 Flutter SDK 安装路径。

    bash
    export PATH="<path-to-sdk>/bin:$PATH"
    

    例如,若你将 Flutter 下载到用户目录下的 develop/flutter 文件夹,可向文件添加:

    bash
    export PATH="$HOME/develop/flutter/bin:$PATH"
    
  4. 保存你的更改

    保存并关闭你编辑的 ~/.zprofile 文件。

  5. 应用你的更改

    要应用此更改并访问 flutter 工具,请在终端应用和 IDE 中关闭并重新打开所有已打开的 Zsh 会话。

  6. 验证你的配置

    为确保你已成功将 SDK 添加到 PATH,请在你偏好的终端中打开 Zsh 会话,然后尝试运行 flutter 和 dart 工具。

    flutter --version
    dart --version
    

    若任一命令未找到,请参阅 Flutter 安装问题排查。

Linux

#

Linux

#

要在 Linux 终端中运行 flutter 和 dart 命令,请将 Flutter SDK 的 bin 目录添加到 PATH 环境变量。

  1. 确定 Flutter SDK 安装位置

    复制你下载并解压 Flutter SDK 所在目录的绝对路径。

  2. 确定你的默认 shell

    若你不确定自己使用哪种 shell,可查看打开新控制台窗口时启动的是哪一种。

    echo $SHELL
    
  3. 将 Flutter SDK 的 bin 添加到你的 PATH

    要将 Flutter 安装目录下的 bin 添加到 PATH:

    1. 展开与你默认 shell 对应的说明。

    2. 复制提供的命令。

    3. 将 <path-to-sdk> 替换为你的 Flutter SDK 安装路径。

    4. 在使用该 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
    
  4. 应用你的更改

    要应用此更改并访问 flutter 工具,请在终端应用和 IDE 中关闭并重新打开所有已打开的 shell 会话。

  5. 验证你的配置

    为确保你已成功将 SDK 添加到 PATH,请使用默认 shell 打开你偏好的终端,然后尝试运行 flutter 和 dart 工具。

    flutter --version
    dart --version
    

    若任一命令未找到,请参阅 Flutter 安装问题排查。

ChromeOS

#

要在 ChromeOS 终端中运行 flutter 和 dart 命令,请将 Flutter SDK 的 bin 目录添加到 PATH 环境变量。

  1. 确定 Flutter SDK 安装位置

    复制你下载并解压 Flutter SDK 所在目录的绝对路径。

  2. 将 Flutter SDK 的 bin 添加到你的 PATH

    要将 Flutter 安装目录下的 bin 添加到 PATH:

    1. 复制以下命令。

    2. 将 <path-to-sdk> 替换为你的 Flutter SDK 安装路径。

    3. 在你偏好的终端中运行编辑后的命令。

    echo 'export PATH="<path-to-sdk>:$PATH"' >> ~/.bash_profile
    

    例如,若你将 Flutter 下载到用户目录下的 develop/flutter 文件夹,可运行:

    echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.bash_profile
    
  3. 应用你的更改

    要应用此更改并访问 flutter 工具,请在终端应用和 IDE 中关闭并重新打开所有已打开的 Zsh 会话。

  4. 验证你的配置

    为确保你已成功将 SDK 添加到 PATH,请在你偏好的终端中打开 Zsh 会话,然后尝试运行 flutter 和 dart 工具。

    flutter --version
    dart --version
    

    若任一命令未找到,请参阅 Flutter 安装问题排查。