git-bug bug show 命令完全指南查看 Bug 详情、字段筛选与三种输出格式【免费下载链接】git-bugDistributed, offline-first bug tracker embedded in git项目地址: https://gitcode.com/GitHub_Trending/gi/git-buggit-bug是一个分布式、离线优先offline-first、内嵌于 Git 的缺陷跟踪工具。git-bug bug show是其中最常用的查看命令之一用于展示单个 Bug 的完整详情——从标题、状态、作者到标签、参与者与全部评论。本文以 doc/md/git-bug_bug_show.md 为核心结合 commands/bug/bug_show.go 的源码实现完整讲解该命令的用法如何定位 Bug、如何用--field只提取某个字段、如何用-f/--format切换 default/json/org-mode 三种输出风格以及每种格式背后的字段来源与工作原理。读完本文你可以熟练地用一条命令查看、筛选并脚本化处理仓库中的任何 Bug 详情。命令概览git-bug bug show [BUG_ID] [flags]功能Display the details of a bug展示一个 Bug 的详细信息所属命令组git-bug bug见 git-bug bug 命令说明对应 man 手册页git-bug-bug-show.1完整选项列表选项说明取值默认值--field string只显示指定字段author, authorEmail, createTime, lastEdit, humanId, id, labels, shortId, status, title, actors, participants空显示完整详情-f, --format string选择输出格式default, json, org-modedefault-h, --help显示命令帮助——第一步如何指定要查看的 Bugshow命令的BUG_ID参数支持两种用法在 commands/select/select.go 的Resolve逻辑中统一处理1. 直接传 ID 前缀git-bug的 Bug ID 是基于 sha-256 的 64 位十六进制字符串见 entity/id.go。为了人类可读可以直接传前 7 个字符的短 IDhuman id甚至更短的前缀命令会通过ResolvePrefix自动补全匹配git-bug bug show 2f153ca从源码结构看ResolveSelectedcommands/bug/bug_select.go会优先把第一个参数当作实体前缀解析成功匹配即直接使用无需完整 ID。2. 使用预先选中的 Bugselect 机制如果之前执行过git-bug bug select 2f15commands/bug/bug_select.go该短 ID 会被写入本地存储的select/bug文件中。之后执行git-bug bug show无需再传任何参数show会自动读取预先选中的 Bug。配合git-bug bug deselect可以清除选中状态。若既没有传入有效 ID、也没有预先选中 Bug命令会返回错误提示you must provide a bug id or use the select command first字段筛选--field 只输出你关心的内容show命令最实用的能力之一是通过--field精确提取单个字段非常适合 shell 脚本与自动化流水线。可用的 12 个字段在 commands/bug/bug_show.go 中定义具体如下字段输出内容对应 Snapshot 来源author作者显示名snap.Author.DisplayName()authorEmail作者邮箱snap.Author.Email()createTime创建时间snap.CreateTime.String()lastEdit最后编辑时间snap.EditTime().String()humanId短 ID前 7 字符snap.Id().Human()id完整 IDsnap.Id()labels标签列表每行一个snap.LabelsshortId短 ID同 humanIdsnap.Id().Human()status状态open/closedsnap.Statustitle标题snap.Titleactors所有参与操作的身份显示名snap.Actorsparticipants所有参与者显示名snap.Participants这些字段全部来自bug.Snapshot——Bug 的 DAG 操作链编译产物见 entities/bug/snapshot.go。典型用法# 只显示标题 git-bug bug show 2f153ca --field title # 只显示状态 git-bug bug show 2f153ca --field status # 只显示作者邮箱适合后续脚本处理 git-bug bug show 2f153ca --field authorEmail注意--field与--format是互斥的使用方式。从 runBugShow 的实现可见一旦指定了--field会走独立的 switch 分支并直接返回只有未指定--field时才会按--format渲染完整详情。若传入不在列表中的字段名会报错unsupported field: 名称。输出格式详解未使用--field时-f/--format控制完整详情的渲染风格支持default、json、org-mode三种。default终端友好的彩色渲染默认格式showDefaultFormattercommands/bug/bug_show.go输出结构如下并带 ANSI 颜色短 ID 青色、状态黄色、作者名品红2f153ca [open] 标题文本 Alice opened this issue 2026-09-10 10:30:00 0800 CST This was last edited at 2026-09-12 14:00:00 0800 CST labels: bug, ui actors: Alice participants: Alice, Bob ab12cd3 #0 Alice aliceexample.com 这里显示第一条评论创建 Bug 时的描述…… ef45ab6 #1 Bob bobexample.com 这里显示后续评论……关键细节评论渲染每条评论前带CombinedId().Human()短 ID7 位与序号#0、#1……后跟评论作者显示名与邮箱。CombinedId的实现见 entities/bug/comment.go。空描述提示某条评论没有正文时会以高亮样式输出No description provided.。数据校验runBugShow在渲染前会检查snap.Comments是否为空若为空会直接报错invalid bug: no comment一个合法 Bug 至少包含创建时的第一条描述见 commands/bug/bug_show.go。json机器可读的结构化输出json格式通过showJsonFormattercommands/bug/bug_show.go调用 commands/cmdjson/bug.go 中定义的BugSnapshot结构序列化输出方便jq等工具进一步处理{ id: 完整 64 位 ID, human_id: 2f153ca, create_time: { timestamp: 1757497800, time: 2026-09-10T10:30:0008:00 }, edit_time: { timestamp: 1757743200, time: 2026-09-12T14:00:0008:00 }, status: open, labels: [bug, ui], title: 标题文本, author: {id: …, human_id: …, name: Alice, login: alice}, actors: [ {id: …, human_id: …, name: Alice, login: alice} ], participants: [ {id: …, human_id: …, name: Alice, login: alice}, {id: …, human_id: …, name: Bob, login: bob} ], comments: [ { id: CombinedId 完整值, human_id: ab12cd3, author: {id: …, human_id: …, name: Alice, login: alice}, message: 第一条评论内容 } ] }结构说明create_time/edit_time使用cmdjson.Time包装commands/cmdjson/json_common.go同时提供 Unix 时间戳与可读时间两个字段。author、actors、participants使用cmdjson.Identity含id、human_id、name、login。每条评论的id是该评论的CombinedId评论与所属操作组合成的实体 IDhuman_id为其前 7 位短形式。配合jq可以轻松做自动化提取例如git-bug bug show 2f153ca --format json | jq .title git-bug bug show 2f153ca --format json | jq .comments[].author.nameorg-modeEmacs Org 生态友好输出org-mode格式showOrgModeFormattercommands/bug/bug_show.go将 Bug 渲染为 Org 大纲结构可以直接导入 Emacs Org 文件2f153ca [open] 标题文本 * Author: Alice * Creation Time: 2026-09-10 10:30:00 0800 CST * Last Edit: 2026-09-12 14:00:00 0800 CST * Labels: ** bug ** ui * Actors: ** a1b2c3d Alice * Participants: ** a1b2c3d Alice ** e4f5a6b Bob * Comments: ** #0 Alice : 第一条评论内容 ** #1 Bob : 第二条评论内容格式要点无 ANSI 颜色纯文本更适合导入文档与版本管理。Actors/Participants输出为短ID 显示名组合。评论正文以:前缀缩进多行内容会把换行符替换为\n:保证 Org 块内格式一致。若评论无正文输出No description provided.。实现原理从命令到 Snapshot 的调用链理解show命令的底层原理有助于把握各字段的真实含义。完整调用链如下命令入口newBugShowCommandcommands/bug/bug_show.go注册 cobra 命令并通过PreRunE: execenv.LoadBackend(env)在运行前加载仓库后端缓存。ID 解析ResolveSelected→_select.Resolvecommands/select/select.go优先解析命令行参数中的 ID 前缀失败则回退到 select 机制。生成快照b.Snapshot()将 Bug 的 DAG 操作链重放、编译为bug.Snapshot结构。字段渲染按--field或--format分发到对应的格式化函数。其中 Snapshot 的EditTime()entities/bug/snapshot.go取的是操作链最后一条操作的时间戳CreateTime则是快照中记录的创建时间Actors与Participants由操作回放过程中去重累积addActor/addParticipant见 entities/bug/snapshot.go。短 ID 的截取规则前 7 位定义在 entity/id.go 与 entity/id_interleaved.go。实际使用建议快速浏览直接git-bug bug show shortId彩色输出一目了然。脚本提取优先用--field拿单字段或--format json拿全量结构化数据再交给jq。Org 工作流若你日常使用 Emacs Org 管理任务-f org-mode可让 Bug 详情无缝嵌入 Org 大纲。配合 select 提效在交互式会话中先git-bug bug select shortId之后反复执行git-bug bug show查看同一 Bug无需重复输入 ID。相关命令与文档延伸git-bug bug列表、git-bug bug select预选、git-bug bug deselect取消预选。【免费下载链接】git-bugDistributed, offline-first bug tracker embedded in git项目地址: https://gitcode.com/GitHub_Trending/gi/git-bug创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考