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

名称

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

概要

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

描述

收集有关用户机器、Git 客户端和仓库状态的信息，并提供一份要求填写用户所观察到行为的表单。所有信息将存储在一个文本文档中，用户随后可以分享该文件（例如发送到 Git 邮件列表）以报告观察到的 Bug。

要求用户提供以下信息

  • 复现步骤

  • 预期行为

  • 实际行为

自动采集以下信息

  • git version --build-options

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

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

  • 已启用的钩子（hooks）列表

  • $SHELL

可以使用 --diagnose 选项将额外信息收集到单独的 zip 归档中，并可随 Bug 报告文档一起发送，为阅读者提供更多上下文。

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

选项

-o <路径>
--output-directory <路径>

将生成的 Bug 报告文件存放在 <路径> 中，而不是当前目录。

-s <格式>
--suffix <格式>
--no-suffix

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

--no-diagnose
--diagnose[=<模式>]

创建一个包含用户机器、Git 客户端和仓库状态补充信息的 zip 归档。该归档文件将写入与 Bug 报告相同的输出目录，并命名为 git-diagnostics-<格式化后缀>。

如果未指定 模式，诊断归档将包含 git diagnose 报告的默认统计数据集。可以指定可选的 模式 值来更改归档中包含的信息。请参阅 git-diagnose[1] 以获取 模式 的有效值列表及其用法详情。

GIT

Git[1] 套件的一部分