简体中文 ▾ 主题 ▾ 最新版本 ▾ git-bugreport 上次更新于 2.45.0

名称

git-bugreport - 收集信息供用户提交错误报告

概要

git bugreport [(-o | --output-directory) <path>]
		[(-s | --suffix) <format> | --no-suffix]
		[--diagnose[=<mode>]]

描述

收集有关用户机器、Git 客户端和仓库状态的信息，以及一个请求用户描述所观察到的行为的表单，并将它们存储在一个单独的文本文件中，用户随后可以共享该文件（例如，共享到 Git 邮件列表）以报告发现的错误。

将向用户请求以下信息

  • 重现步骤

  • 预期行为

  • 实际行为

将自动捕获以下信息

  • git version --build-options

  • uname sysname、release、version 和 machine 字符串

  • 特定于编译器的信息字符串

  • 已启用的钩子列表

  • $SHELL

可以使用 --diagnose 选项将其他信息收集到一个单独的 zip 存档中，并可以将其作为 bugreport 文档的附件，为读者提供额外的上下文。

此工具通过典型的 Git 设置过程调用，这意味着在某些情况下，它可能无法启动 - 例如，如果相关的配置文件不可读。在这种情况下，手动收集上面列出的信息以在手动寻求帮助时可能会很有用。

选项

-o <path>
--output-directory <path>

将生成的错误报告文件放在 <path> 中，而不是当前目录。

-s <format>
--suffix <format>
--no-suffix

为错误报告名称指定一个备用后缀，以创建名为 git-bugreport-<formatted-suffix> 的文件。这应该采用 strftime(3) 格式字符串的形式；将使用当前的本地时间。 --no-suffix 禁用该后缀，文件将仅命名为 git-bugreport，没有任何区分措施。

--no-diagnose
--diagnose[=<mode>]

创建用户机器、Git 客户端和仓库状态的补充信息的 zip 存档。该存档将写入与错误报告相同的输出目录，并命名为 git-diagnostics-<formatted-suffix>。

在未指定 mode 的情况下，诊断存档将包含 git diagnose 报告的默认统计信息集。可以指定一个可选的 mode 值来更改存档中包含的信息。有关 mode 的有效值列表及其使用详情，请参阅 git-diagnose[1]。

GIT

Git[1] 套件的一部分