Flutter项目执行Get Dependencies后pub get失败，版本问题该修改何处？

架构老林

2026-5-20

解决Flutter项目中"pub get failed"的问题

我之前也碰到过完全一样的场景：看到"Packages get尚未运行"的提示，按建议点了"Get Dependencies"结果直接报pub get failed，而且确认问题根源在pubspec.yaml文件。别慌，咱们直接从这个文件入手调整，具体要改的方向主要有这些：

检查依赖版本兼容性
这是最常见的触发原因。打开项目根目录下的pubspec.yaml，找到dependencies或dev_dependencies区块，核对每个依赖的版本是否和你当前的Flutter SDK版本匹配。比如你的Flutter是较新的3.x版本，有些停更的旧依赖可能不兼容，你可以试试把版本号改成更宽松的范围（比如把package_name: ^1.0.0改成package_name: any做临时测试），或者去该包的官方说明页找适配你Flutter版本的正确版本号。
修正YAML文件格式错误
YAML对缩进的要求特别苛刻，必须用空格（绝对不能用Tab键），而且每个层级的缩进长度要统一。比如dependencies下面的每个依赖项都要缩进2个空格，正确格式示例：
```
dependencies:
  flutter:
    sdk: flutter
  cupertino_icons: ^1.0.2
```
如果缩进出错，编辑器通常会标红提示，你可以重点检查这些标红的地方。
排查新增的问题依赖
如果你是刚添加了新依赖后出现的报错，大概率是这个新依赖本身有问题，或者它的依赖链和现有包冲突。你可以先把这个新依赖注释掉（在前面加#），然后重新运行flutter pub get，如果这次成功了，就说明是这个依赖的问题——要么换个兼容的版本，要么找功能类似的替代包。
匹配Flutter SDK与依赖版本
有时候是你的Flutter SDK版本太低，不支持某些依赖的最新版本。你可以在终端运行flutter --version查看当前SDK版本，要么升级Flutter（执行flutter upgrade），要么降低依赖版本来适配旧SDK。