dart pub global

全局是 pub 工具 的命令之一。

Pub 的 global 选项允许您在当前不在包内部时从命令行运行 Dart 脚本。在 激活包 后，您可以从该包的 bin 目录 运行脚本。 停用包 会将其从您的全局可用包列表中删除。

例如，假设您想使用 webdev 从命令行提供您的 Dart Web 应用程序。

$ dart pub global activate webdev
$ webdev serve

如果这不起作用，您可能需要 设置您的路径。

要从包内部或您的包所依赖的包中运行 Dart 脚本，请参阅 dart run。

dart pub global activate [--noexecutables] [--executable=<name>] [--overwrite] <package> [version-constraint]

当您希望能够从命令行运行一个或多个其可执行文件时，激活一个包。您可以激活位于 pub.dev 网站、Git 存储库或本地机器上的包。激活包后，请参阅 运行脚本 以运行包的 bin 目录中的脚本。

激活包时，您可以指定一个可选的版本约束。有关用法示例，请参阅 约束 标志。

$ dart pub global activate <pub.dev package>

指定 pub.dev 网站上的包以激活它。例如

$ dart pub global activate markdown

$ dart pub global activate --source git <Git URL>
$ dart pub global activate -sgit <Git URL>

使用 --source git（或简称 -sgit）激活 Git 存储库中的包。以下激活 GitHub 上的 async_await 包的示例是等效的

$ dart pub global activate --source git https://github.com/dart-lang/async_await.git
$ dart pub global activate -sgit https://github.com/dart-lang/async_await.git

Pub 期望在 Git 存储库的根目录中找到该包。要指定其他位置，请使用 --git-path 选项，该选项使用相对于存储库根目录的路径

$ dart pub global activate -sgit https://github.com/dart-lang/http.git --git-path pkgs/http/

Pub 使用 Git 存储库的默认分支。要指定其他分支或提交，请使用 --git-ref 选项

$ dart pub global activate -sgit https://github.com/dart-lang/http.git --git-ref 36f98e900347335af2338a0e087538009b7de2f9

$ dart pub global activate --source path <path>

使用 activate --source path <path> 激活本地机器上的包。以下示例从 ~/dart 目录激活 stopwatch 包

$ dart pub global activate --source path ~/dart/stopwatch

激活包后，您可以通过再次激活该包来升级它。

您可以直接从命令行运行已激活包中的脚本。如果您无法直接运行脚本，您也可以使用 dart pub global run。

要直接从命令行运行脚本，请将 系统缓存 bin 目录添加到您的 PATH 环境变量中。

例如，假设您已激活 webdev 包，但您仍然无法运行该命令

$ dart pub global activate webdev
$ webdev serve
-bash: webdev: command not found

验证系统缓存的 bin 目录是否在您的路径中。以下 macOS 上的 PATH 变量包含系统缓存

$ echo $PATH
/Users/<user>/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/Users/<user>/.pub-cache/bin

如果您的 PATH 中缺少此目录，请找到适合您平台的文件并添加它。

^* 系统缓存的确切位置可能因 Windows 的不同版本而异。

您现在可以直接调用该命令

$ cd web_project
$ webdev serve

如果脚本仍然无法从命令行运行，则该包可能未 配置 此功能。您仍然可以使用 dart pub global run 运行脚本。

$ dart pub global run <package>:<executable> [args...]

即使未将脚本配置为从命令行运行，您仍然可以使用 dart pub global run。以下命令运行 foo 包中的 bin/bar.dart 脚本，并传入两个参数。

$ dart pub global run foo:bar arg1 arg2

如果您不是包开发者，您可以跳过此部分。

包可以将其某些脚本公开为可执行文件，这些可执行文件可以直接从命令行运行。脚本必须在 pubspec 文件的 executables 条目中列出。例如，以下 pubspec 文件将 bin/helloworld.dart 识别为 helloworld 包的可执行文件

name: helloworld

executables:
  helloworld:

未在 executables 标记下列出脚本会降低脚本的可用性：未列出的脚本可以使用 dart pub global run 执行，但不能直接从命令行执行。

$ dart pub global deactivate <package>

使用 deactivate 从可用全局包列表中删除包。例如

$ dart pub global deactivate markdown

您将无法再使用 dart pub global run 或在命令行中调用该包的脚本。

$ dart pub global list

使用 list 列出所有当前活动包。

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

使用 dart pub global activate <package> [version-constraint] 指定包的特定版本。例如，以下命令提取 markdown 包的 0.6.0 版本

$ dart pub global activate markdown 0.6.0

如果指定范围，pub 会选择满足该约束的最佳版本。例如

$ dart pub global activate foo <3.0.0

使用 dart pub global activate <package> --no-executables 全局激活指定的包，但不将任何可执行文件放入 bin 中。您必须使用 dart pub global run 运行任何可执行文件。

与 dart pub global activate 一起使用以将指定的可执行文件添加到您的 PATH 中。您可以传递多个此类标志。

例如，以下命令将 bar 和 baz（但不是 foo 可能定义的任何其他可执行文件）添加到您的 PATH 中。

$ dart pub global activate foo -x bar -x baz

使用 dart pub global activate <package> --overwrite 覆盖任何先前激活的具有相同名称的全局可执行文件。如果您未指定此标志，则不会替换预先存在可执行文件。

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