经历了极其繁忙的两周(两个汇报、一份文档、两个 PPT、一个视频、三个项目、一堆会议)之后,终于有时间继续完善我的"宝宝指南"了。

在配置环境的过程中(或是之后的写代码时),你大概率会遇到各种各样的问题。有些问题可能无法自己解决,这时候就需要提问。也许有人会问"提问也需要学吗?“我只能说,别小看了提问的艺术——至少对我而言,回答问题的意愿,和问题本身的质量成正比。下面分享两个我真实遇到的例子,大家可以看看哪种提问方式更好:

提问一

我就是打开软件,正常操作了几下,然后就看到软件里出现了图片重复的情况。

提问二

我打开软件,点了拍照按钮,然后点了上传,这个时候照片没有上传,并且在暂存区出现了两张重复的图片。(同时配有一段操作录屏)

相信大家都会更有意愿去排查并回复第二种提问。接下来,就让我们一起学习"提问的艺术”。

提问之前

提问的首要原则,是不做无意义的重复提问。要做到这点,需要遵守两个原则:RTFM(Read The F**king Manual,读文档)和 STFW(Search The F**king Web,搜网络)。

你遇到的问题,大概率文档里已经提过,或者前人已经踩过坑。在网络如此发达的今天,遇到问题的第一反应应该是查文档、搜网页,或咨询 AI。

你可以把问题中的关键词放进搜索框,比如百度、Bing、Google,中文英文都行;也可以去 GitHub 的 issue 区翻翻,八成情况下都能找到一些有效答案。同时也可以使用各类 AI 工具,比如豆包、DeepSeek、ChatGPT 等,只要问题描述清楚(具体怎么描述,下一章会细说),它们大多能给出准确答案。

查资料时注意辨别真伪,尤其是 AI 生成的内容。无脑照搬又正好撞上 AI 的幻觉,反而可能引发更大的问题,那就麻烦了。

在真正提问之前,最好自己对问题多做一些思考,避免去问简单的拼写错误。对问题有思考,也能加深自己的理解;当对方解答时你才能跟得上思路,不至于对方一细问你就"稍等,我再看看",那样会严重影响解决问题的效率。

如何提问

确认拼尽全力仍无法解决问题后,就可以开始提问了。一些核心原则如下:

  1. 说明问题背景、你的期望,以及想要达成的结果。
  2. 详细描述操作步骤(比如点了哪些按钮、写了哪些代码)。
  3. 详细给出操作中的日志,以及得到的错误结果。
  4. 提供最小可复现的代码、操作流程或录屏,方便对方快速定位问题。
  5. 说明自己已经尝试过的措施或思考,避免走重复路子。
  6. 尽量在公共社区平台提问(比如 GitHub 的 issue 区),这样会有更多人看到你的问题,能更快获得回复;同时你的问题也可能帮到同样有此困扰的人。

参考