“求助！我的软件老闪退。” “------具体问题出在哪个步骤？”

如何一次性明确需求，快速获得他人帮助？四步极简教程，助你习得极客社区 GitHub 优雅提问。 第一步：异步沟通

你可以把 GitHub 当成一个主题讨论平台。如何实现？用 GitHub issue 就好——你可以在 GitHub Issues 发起议题，或参与已有议题。

GitHub Issues 的交流特点是：异步沟通。

什么叫异步沟通？ 不妨先来了解同步沟通。

同步沟通：一方发出的信息，必须等待另一方反馈后，才能继续通讯。也就是说，双方在没有相互明确彼此意思前，谈话是被阻塞的，只能进行多次反复确认，才能继续。同步沟通很像我们平时的面对面交谈，也成为主流的在线沟通形式。常见的有微信、QQ 等即时通讯工具。

同步沟通，往往要求双方同时在线，才能跟上讨论的进展，它的弊端是：容易被不了解情况的人撕裂讨论线索。如何解决这个问题？工程师们采用了异步沟通：GitHub Issues（议题）或邮件列表。

异步沟通：所有人的意见或见解，都可以通过 GitHub Issues 页面或邮件追查、对比、反复理解，任何中途介入的人，也都可以通过 Issues 页面全面客观地知晓所有人的观点。再复杂的问题，通过 GitHub Issues 都可以优雅地、非时间强占式地，达成共识。

第二步：提问技巧

无论你用 Issues 来提问什么问题，都别忘了这三个技巧：

1. 一个 issue 只讨论一个问题

一个 issue 发布多个问题，比如 title 为「2w 课程疑问」的 issue 下有五六个当周疑问，相较一个 issue 只讨论一个问题，你觉得哪个 issue 更便于展开讨论、追踪和后期归档？

2. 标题力求简短准确地描述问题

例如「写作实践中遇到的一些问题」 VS 「如何利用积累的卡片写出一篇文章？」 ，你更倾向点开哪个 issue 参与讨论？

3. 提问内容使用「绝对坐标」

数学术语中，把结合情境的表达称为「相对坐标」，不结合情境的表达称为「绝对坐标」。在 Issues 描述问题细节时，请使用绝对坐标沟通：假设每个与你沟通的都是陌生人，你需要交代清楚背景，并简练地将事情给说明白。

反之，什么是相对坐标？想象一个画面：

深夜，一休回家后仍在辛勤工作，在测试 app 时，发现了隐藏的新问题。“app 出问题啦！” 一休在工作群快速反馈。

猜猜看，网络另一端的 IT 同事，能否明白一休说的是什么问题吗？

如果同事正好在一休身边，在听到“app 出问题啦”后过来看一眼屏幕，马上就能明白情况。但此时此刻，单纯说“app 出问题啦”，对迅速解决问题的帮助，远不如”在 app 的 xx 界面点击 xx 按钮之后，app 出现闪退”。后者既能帮助 IT 同事迅速定位问题，也方便其他同事知晓情况。

第三步：提问示范

这是 Github 上流行的一个库 FreeCodeCamp ，先看看这第一位同学的提问，这也是多数小白习惯的提问：

再看看第二位同学的提问，这是个网络素养更好的提问。

两人同在 Issue 中提问，但结果不一样，这是为什么？因为第二位同学清楚阐述了如下要点：

我为了解决这个问题，付出了什么样的努力？ 我哪些地方解决了，哪些地方没解决？ 我的问题是在什么样的环境之下出现的？ 提供对应截图。

结果是，同第一位无人问津的小白相比，第二位同学得到了 89 人的帮助。

第四步：结束提问

GitHub Issues 相较常见 BBS、论坛最大的区别是它可以 Close 和 Reopen 。如果你发起的议题已经讨论完毕，请及时回复（comment）最新进展/解决方案到这个 issue 下并 Close issue，有始有终，让协作者知道这个议题已完成；同时保持主界面清爽。

当然，close Issue 不仅仅是点击 close ，请在 comment 中附上相关链接，以便他人继续追踪:

Issue 成果的链接（通常是 wiki/code 等成品页面） 或者是由此引发的新 Issue 及链接 或说明结果为 Happy ending 还是过期关闭还是其他

Issue close 后，若再需开启，可以 reopen ，同时最好说明原因，以便看到 Issue 的同伴迅速进入状态，开始共创。■

习得优雅提问， 体验异步沟通乐趣

入门信息分析，开启 GitHub 学习之旅