使用免费开源软件时遇到问题该怎么办？

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

提问前

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

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

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

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

提问规范

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

正确示例：

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

错误标题：

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

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

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

注意：

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

社交礼仪

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

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