上游 · 理解本功能前需先掌握的（1）：
下游 · 依赖/承接本功能的（0）：
暂无下游（建议学完它再进阶）
前置依赖包含从属概念升级流程承接
边方向 = 学习顺序（A→B 表示先学 A 再学 B）
为什么需要它
心智模型
有些话题没有明确的对错、也不需要「处理完关闭」——比如「这个功能该怎么设计？」「谁来用这个库？」Issue 把这类讨论记上去反而碍事。讨论区（Discussions）就是仓库里的「开放广场」：想聊就发帖、想收藏就顶，没有完成态的压力，是社区运营和收集想法的理想场所。
历史背景 · 它为什么诞生诞生于 2020
诞生社区对话（提问、功能讨论、FAQ）不适合塞进线性格式的issue/PR。2020-05-06随Satellite推出Discussions beta，提供线程化、可标记回答、不关闭的讨论空间，专为"代码库之外的知识积累"设计。
功能介绍
讨论区（Discussions）是 GitHub 为仓库提供的开放式交流功能，你可以把它理解成仓库自带的「论坛」。相比问题（Issue），Discussion 更宽松：Issue 强调「一个可追踪、要关闭的工作项」，而 Discussion 适合开放式问答、想法分享、公告通知等不需要强制闭环的对话。每个仓库可以按需开启 Discussions 功能，内部按分类（Category）组织帖子，例如「公告（Announcements）」「问答（Q&A）」「想法（Ideas）」「一般讨论（General）」。用户可以在分类下发帖、评论、点赞和关注，作者可以把满意的回答标为答案（Answer）方便后来者查找。它的典型价值是社区运营：新人在这里提问不会被当成 bug 提交；维护者在这里收集用户反馈和功能投票，再筛选出有价值的想法转成 Issue 正式立项。
核心术语
讨论区（Discussions）分类（Category）公告（Announcements）问答（Q&A）答案（Answer）
适用场景
- 当你想收集用户对产品功能的想法和反馈时，用 Ideas 分类发起讨论。
- 当用户问使用问题、而非报 bug 时，引导到讨论区的问答（Q&A）分类。
- 当你想发项目公告、更新说明时，用公告（Announcements）分类发帖。
- 当讨论成熟、结论要落实为代码时，把帖子转成正式 Issue 立项。
怎么操作（网页 vs 命令行 双轨）
🖱️ 网页操作 (GitHub.com)
- 进入仓库，点击 Settings → 勾选 Enable Discussions 开启讨论区。
- 在 Discussions 页点击 New discussion，选择分类（Q&A / Ideas / General 等）并填写内容。
- 发布后在帖子下参与回复、点赞；作者可在问答中把满意回复标为答案（Answer）。
- 若结论需要落实，在帖子里点 Convert to issue 转成 Issue 跟踪。
⌨️ 命令行 (进阶)
gh api repos/你的账号/仓库名/discussionsgh api -X POST /repos/你的账号/仓库名/discussions -f title=xxx -f body=yyy -f category=Q&A
新手建议先从网页操作入手，熟悉概念后再尝试命令行。命令行是真实开发中更常用的方式。
与其他功能的关系
| 关系（前置依赖 / 包含从属 / 概念升级 / 流程承接） | 说明 |
|---|---|
| 前置依赖创建仓库（Create Repository） | 在仓库中开启讨论区 |
官方文档
小结
SUMMARY
讨论区是仓库的开放论坛：比 Issue 更宽松，分分类、聊想法、收集反馈，成熟后再转成 Issue。它让「交流」和「执行」各归其位。下一步学 Wiki，把项目文档沉淀成可协作维护的维基。