Windows11下Flutter新项目提示“Pub get has not been run”的解决求助

云原生阿岚

2026-8-7

解决Flutter新项目“Pub get has not been run”报错方案

手动在终端执行命令
打开项目根目录的终端，执行flutter pub get（Dart项目执行dart pub get），查看终端输出的具体错误信息——比如网络超时、依赖冲突，针对性解决。如果是网络问题，可配置国内镜像：设置环境变量PUB_HOSTED_URL=https://pub.flutter-io.cn和FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn，或者修改项目pubspec.yaml添加镜像源。
检查Flutter SDK路径配置
确认IDE（Android Studio/VS Code）里的Flutter SDK路径正确：Android Studio可通过File > Settings > Languages & Frameworks > Flutter查看，VS Code按Ctrl+,搜索“Flutter SDK Path”。路径必须指向Flutter安装根目录，且路径中不能包含中文或特殊字符。
清理缓存后重试
先执行flutter clean清理项目缓存，再重新运行flutter pub get；也可以删除用户目录下的.pub-cache文件夹，清理Flutter全局缓存后再执行pub get。
检查插件与SDK版本兼容性
确保IDE的Flutter/Dart插件版本和本地Flutter SDK版本匹配，比如SDK用稳定版，插件也更新到对应稳定版。可在IDE插件市场更新至最新兼容版本。
排查项目文件问题
检查新项目的pubspec.yaml是否存在语法错误，比如缩进错误、依赖名称拼写错误，这类问题会直接导致pub get失败，可对比官方示例项目的文件格式修正。
以管理员身份运行IDE
右键IDE图标选择“以管理员身份运行”，避免因权限不足导致pub get无法正常执行，之后重新打开项目执行依赖获取。