很多人在使用开源软件时,因为「不擅长」提问,给开源作者和自己都带来了很多困扰,本文结合 LeanCloud 工程师曾分享的「社区发帖规范」为大家分享一些如何提问的小经验,帮助大家在遇到问题时能够更快地得到解决。

提问前

在与开源作者联系前,我们可以尝试以下方式:

  • 阅读开源项目开发文档
  • 在常见问题(FAQ)中寻找答案
  • 尝试互联网搜索关键词寻找解决方法

在遇到问题时我们可以先通过查询文档尝试解决。一般来说,开源软件的作者都会写一份文档来帮助使用者。在使用开源软件的过程中,部分问题能够在文档中找到答案,如果找不到,我们还可以在 Stack Overflow (特别是比较流行的开源软件)以及这个开源软件在 github 仓库的 issue(如果这个开源软件在 github 有仓库)中试一试。

在文档内容过多时,还可以尝试使用搜索关键词快速找到对应内容。

提问规范

首先我们应该写一个好的标题,尽量用一句话描述清楚问题,并标明所使用的语言、平台。

正确示例:

  1. 小程序真机上传数据时,控制台存储中显示的 Class 表名被压缩为单个字母。
  2. 配置 download 合法域名时显示「该域名因违规被禁止设置。」

错误标题:

  1. 救命,突然就运行不了了
  2. 这两天也有人反馈同样的问题,还是不行的

除了描述清楚问题外,最好还能够提供一些更加详细的信息,这些可以帮助原作者更快定位问题,为你提出解决方案。

  • 仔细清楚地描述问题,包含前因后果
  • 完整的复现代码
  • 提供如硬件设备、操作系统、软件版本、网络等环境信息

注意:

在提问涉及代码部分时,注意不要使用图片来展示代码,因为没有人会照着图片手敲代码。

社交礼仪

开源软件作者通常没有义务免费帮我们解决问题,所以在寻求帮助时,说明来意,并使用「请」、「谢谢」等礼貌用语,以感谢作者们无偿花时间帮助我们,友好礼貌的社交方式也会增加我们得到有用回复的机会。

最后,希望大家看完这篇内容后都能够学会如何更好地解决问题,开源项目的用户和作者之间不是甲方和乙方的关系,碰到问题时更多应该抱着「一起合作来解决这个问题」的心态,共同的输入,才会出现更多优秀的开源项目。

03-05 14:29