Flutter命令无法正常运行，提示找不到'suppress-analytics'选项

核心排查步骤 #

• 确认FLUTTER_HOME环境变量指向Flutter SDK根目录（而非bin子目录）
• 系统Path变量中仅添加FLUTTER_HOME/bin路径，移除单独配置的Dart路径（Flutter自带完整Dart环境，单独配置会导致冲突）
• 环境变量修改后必须重启终端（或命令行窗口）才能生效

Windows系统具体操作 #

1. 打开「系统属性」→「高级」→「环境变量」
   • 在系统变量中创建或修改FLUTTER_HOME，值设为Flutter SDK根目录（例：C:\flutter）
   • 在系统变量的Path中添加%FLUTTER_HOME%\bin，并将其移至列表最顶端（避免路径优先级冲突）
2. 打开新的CMD/PowerShell，执行以下命令验证路径：

   echo %FLUTTER_HOME%
   echo %Path%
   

3. 删除Flutter SDK目录下的bin/cache文件夹，重新运行flutter doctor
4. 尝试以管理员身份启动命令行执行Flutter命令

Mac/Linux系统具体操作 #

1. 编辑shell配置文件（~/.bash_profile或~/.zshrc，根据使用的shell选择），添加：

   export FLUTTER_HOME=/Users/你的用户名/flutter
   export PATH=$FLUTTER_HOME/bin:$PATH
   

2. 执行命令使配置生效：

   source ~/.bash_profile  # Bash用户
   source ~/.zshrc        # Zsh用户
   

3. 验证路径配置：

   echo $FLUTTER_HOME
   echo $PATH
   

4. 删除Flutter SDK下的bin/cache目录，重新运行flutter doctor
5. 赋予SDK目录权限（若存在权限问题）：

   sudo chmod -R 755 $FLUTTER_HOME
   

额外注意事项 #

• Flutter SDK必须解压到无中文、无空格的路径下（例：Windows避免放在「桌面」「我的文档」，Mac避免中文命名文件夹）
• 重新下载SDK时优先使用官方压缩包，不要用Git克隆（避免克隆不完整导致的文件缺失）

内容的提问来源于stack exchange，提问作者Aousaf