Skip to main content

此版本的 GitHub Enterprise 将停止服务 2022-06-03. 即使针对重大安全问题,也不会发布补丁。 要获得更好的性能、改进的安全性和新功能,请升级到 GitHub Enterprise 的最新版本。 如需升级方面的帮助,请联系 GitHub Enterprise 支持

使用 GitHub CLI 扩展

了解如何使用其他 GitHub CLI 用户编写的自定义扩展。

关于 GitHub CLI 扩展

注意: GitHub Enterprise Server 和 GitHub CLI 以外的 扩展未经 GitHub Enterprise Server 认证,并受单独的服务条款、隐私政策和支持文档的约束。 要在使用第三方扩展时降低风险,请在安装或更新扩展之前审核扩展的源代码。

GitHub CLI 扩展是任何人都可以创建和使用的自定义 GitHub CLI 命令。 有关如何创建 GitHub CLI 扩展的详细信息,请参阅“创建 GitHub CLI 扩展”。

扩展在本地安装,范围限定为用户。 因此,如果您从另一台计算机访问 GitHub CLI ,或者其他用户从同一台计算机访问 GitHub CLI ,则该扩展将不可用。

查找扩展

您可以通过浏览具有 gh-extension 主题的存储库来查找扩展。

安装扩展

要安装扩展,请使用 extensions install 子命令。 将 repo 参数替换为扩展的存储库。 您可以使用完整的URL,例如 https://github.com/octocat/gh-whoami,也可以仅使用所有者和存储库,例如 octocat/gh-whoami

如果使用所有者和存储库,gh 将使用当前向 gh 验证的主机名安装扩展。 从其他主机安装扩展时,完整的 URL 格式非常有用。 例如, GitHub Enterprise Server 上的用户应使用完整存储库 URL 从 GitHub.com 或任何其他主机安装扩展。

要从当前目录安装开发中的扩展,请使用 . 作为 repo 参数的值。

gh extension install repo

如果已安装同名的扩展,则该命令将失败。 例如,如果您已经安装了 octocat/gh-whoami,则必须先将其卸载,然后再安装 hubot/gh-whoami

查看已安装的扩展

要查看所有已安装的扩展,请使用 extensions list 子命令。 输出还将告诉您哪些扩展具有可用的更新。

gh extension list

更新扩展

要更新扩展,请使用 extensions upgrade 子命令。 将 extension 参数替换为扩展的名称。

gh extension upgrade extension

要更新所有已安装的扩展,请使用 --all 标志。

gh extension upgrade --all

卸载扩展

要卸载扩展,请使用 extensions remove 子命令。 将 extension 参数替换为扩展的名称。

gh extension remove extension