简体中文 ▾ 主题 ▾ 最新版本 ▾ 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 归档文件中,并可以将其与错误报告文档一起附加,以便为读者提供更多上下文。

此工具通过典型的 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] 套件的一部分

scroll-to-top