dart pub downgrade

降级 是 pub 工具 的命令之一。

$ dart pub downgrade [--[no-]offline] [-n|--dry-run] [dependencies...]

如果没有其他参数， dart pub downgrade 会获取当前工作目录中 pubspec.yaml 文件中列出的所有依赖项及其 传递依赖项 的最低版本。例如：

$ dart pub downgrade
Resolving dependencies... (1.2s)
+ barback 0.13.0
+ collection 0.9.1
+ path 1.2.0
+ source_maps 0.9.0
+ source_span 1.0.0
+ stack_trace 0.9.1
Changed 6 dependencies!

dart pub downgrade 命令会创建一个锁文件。如果锁文件已存在，pub 会忽略该文件并从头开始生成一个新文件，使用所有依赖项的最低版本。

有关包解析和系统包缓存的更多信息，请参阅 dart pub get 文档 。

可以告诉 dart pub downgrade 将特定依赖项降级到最低版本，同时尽可能保留其他依赖项。例如：

$ dart pub downgrade test
Resolving dependencies...
  barback 0.15.2+2
  bot 0.27.0+2
  browser 0.10.0+2
  chrome 0.6.5
  collection 1.1.0
  path 1.3.0
  pool 1.0.1
  source_span 1.0.2
< stack_trace 0.9.2 (was 1.1.1)
  stagexl 0.10.2
< test 0.10.0 (was 0.11.4)
These packages are no longer being depended on:
- matcher 0.11.3
Changed 3 dependencies!

如果要降级特定依赖项，pub 会尝试查找符合新依赖项约束的任何传递依赖项的最高版本。结果通常也会降级任何传递依赖项。

如果在运行 dart pub downgrade 之前向 pubspec 中添加了依赖项，它会获取新的依赖项及其任何传递依赖项。这与 dart pub get 的行为相同。

如果在运行 dart pub downgrade 之前从 pubspec 中删除了依赖项，则该依赖项将不再可用作导入。只要没有剩余的直接依赖项也依赖于它们，任何已删除依赖项的传递依赖项也会被删除。这与 dart pub get 的行为相同。

如果没有网络访问权限，仍然可以运行 dart pub downgrade 。由于 pub 将包下载到系统上所有包共享的中央缓存中，因此它通常可以在无需使用网络的情况下找到以前下载的包。

但是，默认情况下，如果存在任何托管依赖项， dart pub downgrade 会尝试联机。如果不想让 pub 这样做，请传递 --offline 标志。在脱机模式下，pub 只在本地包缓存中查找，尝试从已有的可用版本中找到一组可与您的包一起工作的版本。

有关适用于所有 pub 命令的选项，请参阅 全局选项 。

默认情况下，pub 会连接网络以检索托管的包（--no-offline）。要改为使用缓存的包，请使用 --offline。详情请参见离线获取。

报告哪些依赖项将会更改，但不会更改任何依赖项。

将 pubspec.yaml 中依赖项的下限更新为与解析的版本匹配，并返回已更改约束的列表。可以应用于 特定依赖项 。

在 Pub 工作区 中， dart pub downgrade 将降级整个工作区中的所有依赖项。

除非另有说明，否则本网站上的文档反映的是 Dart 3.6.0。页面最后更新于 2025-02-05。 查看源代码 或 报告问题.