跳转至正文

将 Flutter 添加到 PATH

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

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

Windows

#

要在 Windows 终端中运行 flutterdart 命令,请将 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,请打开命令提示符或你偏好的终端应用,然后尝试运行 flutterdart 工具。

    flutter --version
    dart --version
    

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

macOS

#

要在 macOS 终端中运行 flutterdart 命令,请将 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 会话,然后尝试运行 flutterdart 工具。

    flutter --version
    dart --version
    

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

Linux

#

Linux

#

要在 Linux 终端中运行 flutterdart 命令,请将 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 打开你偏好的终端,然后尝试运行 flutterdart 工具。

    flutter --version
    dart --version
    

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

ChromeOS

#

要在 ChromeOS 终端中运行 flutterdart 命令,请将 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 会话,然后尝试运行 flutterdart 工具。

    flutter --version
    dart --version
    

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