简体中文 ▾ 主题 ▾ 最新版本 ▾ 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) 字符串

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

  • 已启用钩子 (hooks) 的列表

  • $SHELL

可以使用 --diagnose 选项将额外信息收集到单独的 zip 压缩包中，并可以将其与错误报告文档一起附加，以便为阅读者提供更多上下文。

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

选项

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

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

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

为错误报告名称指定一个替代后缀，以创建一个名为 git-bugreport-<格式化后缀> 的文件。这应采用 strftime(3) 格式字符串的形式；将使用当前的本地时间。--no-suffix 将禁用后缀，文件将直接命名为 git-bugreport，不包含任何区分标识。

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

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

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

GIT

Git[1] 套件的一部分