运行flutter doctor卡在Building flutter tool...无响应该如何解决

1. 清理损坏的缓存文件 #

• 终止所有正在运行的Flutter、Dart相关进程
• 删除Flutter SDK根目录下的bin/cache文件夹，该目录存放预编译工具与依赖缓存，文件损坏会直接导致构建流程卡住
• 执行flutter clean清理残留的项目级缓存

2. 手动执行pub升级排查问题 #

• 进入Flutter SDK安装路径下的packages/flutter_tools目录
• 执行dart pub upgrade --verbose，该命令会输出详细执行日志，可直接定位是依赖拉取环节还是编译环节出现异常
• 手动执行成功后，返回Flutter SDK根目录重新执行flutter doctor

3. 排查环境变量冲突 #

• 执行echo $PUB_HOSTED_URL、echo $FLUTTER_STORAGE_BASE_URL检查是否配置了异常的pub镜像源，错误的镜像源即使网络正常也会导致依赖拉取失败，可临时清空这两个环境变量后重试
• 确认本地没有单独安装Dart SDK，避免和Flutter内置的Dart SDK出现版本兼容冲突

4. 检查权限与目录限制 #

• 确认Flutter SDK所在目录没有读写权限限制，不要将SDK放在系统级受保护目录、需要管理员权限才能写入的路径下
• macOS用户可到「系统设置-隐私与安全性」页面确认系统没有拦截Dart相关进程的执行

5. 残留文件清理重装 #

如果上述步骤都无效，完全删除原有Flutter SDK目录，重新下载对应版本的SDK压缩包解压安装，不要覆盖原有目录安装，避免损坏文件残留导致问题复现。

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