Windows环境下Flutter安装及Dart插件异常问题求助

核心问题 #

• 已按官网步骤解压Flutter并配置PATH，但CMD/PowerShell中执行Flutter命令无效
• Dart SDK命令可正常执行，但VSCode安装Dart插件后频繁弹出分析服务器崩溃提示：

  'The Dart Analysis Server crashed 5 times in the last 3 minutes. The server will not be restarted. See the output for more information.'

• CMD执行flutter doctor报错：

  Error: Unable to find git in your PATH.
  [Process finished with exit code 1 (0x00000001)]
  

  （注：Git已正确安装）
• 管理员身份运行CMD执行Flutter命令时窗口自动关闭；PowerShell执行报错：

  Error running 'flutter.bat': The system cannot find the file specified.
  At line:1 char:1
  + flutter doctor
  + ~~~~~~~~~~~~~~.
  At line:1 char:1
  + flutter doctor
  + ~~~~~~~~~~~~~~
      + CategoryInfo          : ResourceUnavailable: (:) [], ApplicationFailedException
      + FullyQualifiedErrorId : NativeCommandFailed
  

• 已尝试的无效方案：反复重装VSCode、测试不同版本Flutter/Dart SDK、迁移Flutter文件夹、添加多种Git/PowerShell路径

1. 彻底检查PATH配置（关键） #

• 打开「系统属性」→「高级」→「环境变量」，分别检查用户变量和系统变量中的Path：
  • 确保Flutter安装目录下的bin文件夹路径（如D:\flutter\bin）放在Path最靠前位置，避免被其他冲突路径覆盖
  • 确保Git的bin路径（如C:\Program Files\Git\bin）和cmd路径（C:\Program Files\Git\cmd）都添加到Path中，同样放在靠前位置
• 配置完成后必须重启所有打开的CMD/PowerShell/VSCode，新PATH才会生效
• 验证：在CMD中执行where git和where flutter，确认能输出正确路径

2. 修复Flutter.bat执行权限与路径问题 #

• 找到Flutter安装目录下的flutter.bat文件，右键→「属性」→「安全」，确保当前用户（含管理员账户）拥有「读取和执行」权限
• 避免将Flutter安装到含中文/空格的路径（如D:\我的软件\flutter或D:\flutter sdk），改为纯英文无空格路径（如D:\flutter）
• 在PowerShell中直接执行完整路径的flutter.bat测试：& "D:\flutter\bin\flutter.bat" doctor，查看是否能正常运行

3. 解决VSCode Dart分析服务器崩溃问题 #

• 打开VSCode，按Ctrl+Shift+P输入Dart: Select SDK，手动指定Flutter目录下的Dart SDK路径（如D:\flutter\bin\cache\dart-sdk），不要单独使用外部安装的Dart SDK
• 按Ctrl+Shift+P输入Dart: Restart Analysis Server，若仍崩溃则删除VSCode的Dart插件缓存：
  • 关闭VSCode，删除路径%USERPROFILE%\.vscode\extensions\dart-code.dart-code-<版本号>\server下的所有文件
  • 重新打开VSCode，插件会自动重新下载分析服务器文件

4. 管理员权限执行问题处理 #

• 不要直接右键以管理员身份打开CMD/PowerShell，先以普通用户打开CMD，执行runas /user:管理员账户 cmd，在新打开的管理员CMD中先执行echo %PATH%，检查Flutter和Git路径是否存在
• 若管理员账户PATH中无Flutter/Git路径，需在系统变量的Path中添加（而非用户变量），系统变量对所有账户生效

5. 重置Flutter配置 #

• 在普通用户CMD中执行flutter config --clear，重置Flutter所有配置
• 执行flutter doctor --android-licenses（按需操作），再重新运行flutter doctor检查问题

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