--- url: /blog/3f6v4l8j/index.md --- > **Eric S. Raymond** 在2004年发表过一篇 `How To Ask Questions The Smart Way` 文章，最新版是2014年的3.10版，原文网址：。 这篇文章写的非常好，令人深受启发。然**原文过于冗长**，有很多信息也已经过时；网上的中文版大多是照搬翻译，语感不佳，有浓厚的译制片配音的语调。且文章是站在国外程序员的视角写的，与中国特色社会主义程序员不符。为了更好的宣扬`提问的智慧`，本文对原文做了大量的删减和本土化改造，更贴近中国程序员的实际情况。 ## 如何做提问前的准备 在你向社区或者其他非亲非故的同行咨询技术问题之前，你应该**先做以下事情**： 1. 在社区的 `Issus` 或者 `FAQ` 中尝试寻找答案 。 2. 尝试使用 **Google** 搜索，不推荐使用 `Baidu` ， 应使用**关键词**搜索，而不是口语化表述。如果使用的是国外的技术或框架，优先用英文关键词搜索。 3. 查看官方文档、使用手册。 4. 先自己思考或通过试验的方式尝试解决。即便解决不了，你也可以获得更多有用的信息。 5. 先找自己团队或者认识的发量较少的朋友咨询。 6. **如果你是程序员，尝试阅读源代码以找到答案**。如果你不是或者你认为自己不是，请忽略此条。 如果你做了上述事情，你就`获得了向他人提问的资格`。提问时，先说明你做了上述尝试，以及你从中发现了哪些关键信息，这会给对方留下一个好的印像。**他们会觉得你是同道中人，也是一个努力上进的好青年。** **审问之，慎思之**。好的答案不是免费的，要么你付费咨询，要么**请用一个好的问题来做交换**。轻率的提问只能得到轻率的回答，或者如石沉大海。 ## 如何提问 ### 仔细挑选提问的论坛 在**合适的地方提问**，和提出一个好的问题同样重要，永远不要到肯德基里询问麦当劳怎么走。 `GitHub Issus` 和 `Stack Overflow` 通常是很合适的编程问题的论坛，如果你不明白 `Stack Overflow` 的含义的话，那就不适合在那提问了，百度贴吧才是你真正的朋友。 ### GitHub Issus 如果你用到 `GitHub` 上的开源项目，那你可以先到 `GitHub` 的项目官网中去搜索 Issus ，看是否有类似的问题。如果没有的话，你可以提一个新的 Issus 。 在提 Issus 时，需要遵守官方对 Issus 定义的格式和内容要求，否则你很难得到回复。**国内的开源项目，你被回复的可能性是比较低的。** 毕竟国内程序员的压力都比较大，开源生态环境也有待改进。这不是某一个作者或者组织的责任，**开源兴亡，匹夫有责**，提出一个好的问题，就是一个好的开端。 ### `Stack Overflow` `Stack Overflow` 是 `Stack Exchange` 旗下的一个子站， 谷歌对 `Stack Exchange` 的页面信息是实时索引的，如果你在谷歌中用英文关键词搜索的话，通常首页就会有 `Stack Overflow` 的搜索结果，如果没有的话，说明这个问题过于生僻或者关键词没用对。 如果你不会科学上网的话，你也可以用百度进行搜索，只不过多了一个步骤： - 第一步：在百度里搜索 `Stack Overflow` , 找到其官网并点击进入（注意避开广告）。 - 第二步：在 stackoverlfow 中进行关键词搜索。 `Stack Exchange`已经发展到超过100个站点 ，以下是最常用的几个子站点： - `Super User` 是关于通用计算的问题。如果你的问题和代码无关，或者你说的只是程序在网络连接上的问题，九成在这里问。 - `Stack Overflow` 是关于编程问题。 - `Server Fault` 是关于服务器和网络管理的问题。 有几个项目有自己的特定站点，包括`Android`、`Ubuntu`、`TeX/LaTeX`和`SharePoint`。请检查一下`Stack Exchange`以确定现在具体有哪些站点。 ### 官方组织的聊天群通常响应最快 很多商业和开源项目都提供了聊天群，**国外通常是 `Slack` ,国内通常是 QQ 或 微信群** 。在这些群里提问的话，通常会很快得到响应，而且群里都会有官方的技术支持人员解答问题。 ### 使用有意义且明确的标题 在提问时，请使用**简洁、清晰、一针见血**的标题，自觉抵制那些无意义的口水话。**『请问有没有人能帮帮我！！』** 基本上与\*\*在吗？\*\*同义。不要妄想用卑微、痛苦的语言去打动别人，**技术社区不相信眼泪**。 **愚蠢：** > 救命啊！这个系统宕机了！ **明智：** > java8 应用无响应，硬件资源正常 **更明智：** > springboot 项目启动阻塞，启动线程卡在 dubbo 注册方法 ### 用清晰、条理化、拼写正确的语句书写 一个粗心与草率的提问者，通常也是一个粗心和草率的程序员，工作如此，生活亦如此。自己不认真对待遇到的问题，又岂能期望他人会认真对待。 用词正确简洁、条理清楚、详略得当，这样的问题更容易得到他人回复。 所有的技术社区都支持 `markdown` 语法（如果不支持，那它就不是一个技术社区），恰当的使用 markdown 语法，如高亮、加粗、列表等，能让你的问题更容易被他人理解。 如果你需要在英文技术社区提问，你可以借助 Google 翻译将你的中文提问转成英文后进行提问。 ### 描述问题应准确且有内容 - 仔细、清楚地描述问题的症状 - 描述问题发生的环境（主机、操作系统、应用程序等） - 描述提问前做过的研究及其理解 - 描述提问前为确定问题而采取的诊断步骤 - 描述最近对计算机或软件配置的任何相关改变 - 如果可能，提供在可控环境下重现问题的方法 尽最大努力预测别人会提到的问题，并提前备好答案，这样可以提高沟通的效率。 如果你认为是代码有问题，则应该提供可复现的测试代码和样例，这会让你得到回复的几率大幅增加。 西蒙 · 泰瑟姆（Simon Tatham）写过一篇如何有效报告`Bug` 的文章，我强烈推荐各位阅读。 ### 别急于宣称找到`Bug` 当你在一个软件或开源项目中遇到问题，除非你 **非常、非常** 的有把握，否则不要大声嚷嚷找到了`Bug` ， 轻则被打脸，重则被社区拉入黑名单。 > 提示：除非你直接定位到代码中的问题，或者出现和前面版本不一样的测试结果，否则你大概率是错的。 程序员听到别人声称找到 `Bug` 的第一反应是 **“这不可能”** ，第二反应是 **“你用错了吧”** 。 就算你真的找到 Bug 了，也应礼貌友好的指出。 **大声嚷嚷：“你这写的啥呀，是不是没测试就发出来了呀”** 对于解决问题没有帮助，只会得到“你行你上”的回复。 ### 有节制的提出请求 直接要求他人帮你解决问题是愚蠢且自私的。在你遇到问题，寻求他人帮助时，你应抱着**一定要自己解决的信念**，别人只是给你提供解决思路和纠正错误。没有人有帮你解决问题的义务，合理有节制的提出请求，你才有可能得到他人的回复。 ### 礼多人不怪 礼貌一点，使用『**你好**』、『**请**』、『**谢谢**』，让别人明白你感谢他们无偿的帮助。 ### 问题解决后有回复 有些人在他人帮助下解决了问题就销声匿迹，远走高飞。别人花费大量时间提供帮助，而他却在问题解决后不愿向帮助的人说明一下结果。 问题解决后向所有帮助过的人回一条消息，让他们知道问题是如何解决的并再次感谢。有来有往，来日方长。 如果问题比较复杂，可以梳理总结一篇文章发出来，一来可以自己巩固，二来可以帮助他人。前车之鉴，后事之师。 ## 如何理解别人的回复 ### `RTFM`和 `STFW` 意思是你的问题很傻很天真 **STFW** , 全名是 `Search The F**king Web` ， 它还有个弟弟叫 `RTFM`, 全名是 `Read The F**king manual` 。 `STFW` 还有一个温和点的说法，叫 `Google is your friend` ,对于不会科学上网的国内程序员，那就是 `baidu is your friend` 。 如果你收到这样的回复，那这就是你能收到的最好的答案，你应该照做，去网上查一下，或者看一下手册。这样的回复虽然有些难以接受，但你不应该觉得被冒犯，因为别人已经给了你正确的答案。如果你还觉得难以接受，你应该把 `STFW` 设置为你的屏保，时刻提醒自己，别再提这么傻的问题了。 ### 对待无礼 国内的评论区已基本被杠精占领，**技术社区**这一片唯一的净土也难以独善其身，肆意的谩骂、互相 diss 已是司空见惯。评论区的提示信息不是**请遵守法律** ，就是善意的提醒**善语结善缘，恶言伤人心**。这是必须承受之痛，欲练此功。。欲带皇冠,必承其重。 如果面对的是毫无意义的谩骂、轻视，这种纯粹的恶意仅仅是对方的一种发泄，目的就是引起你的愤怒。如果你愤怒了，那正中其下怀。 如果对方只是无礼的给出了有用的信息，那就说明他是一个刀子嘴豆腐心的人，嘴上说着不要，但想要帮助别人的心还是很诚实的。如果你愤怒了，反倒显的小气了。 ## 别像失败者那样反应 技术上的争论应该是君子之争，就事论事，理越辩越明。 谩骂、诋毁，或者是如祥林嫂般去知乎上宣称自己遭遇的不公正待遇，这样的回应只会让自己变成自己讨厌的那个人。 君子量不极,胸吞百川流。不要做意气之争，不要把有限的精力放在无谓的争执上。 `Big Endian or Small Endian , it's not a question` . ## 如何更好的回答他人 前面都在说如何更好的提问，下面说说做为被提问的一方，如何更好的回答他人的问题。 - **态度和善一点**。 遇到难题时的压力可能会让人显得无礼或愚蠢，但你要知道，这并不是真实的他。他只是遇到难处了，宽容善待他人，也是体现自己的良好修养。良言一句三冬暖，恶语伤人六月寒。 - **对初犯者私下回复**。 对那些无心之失没有必要当众羞辱。闻道有先后，术业有专攻，如是而已。人非生而知之者，大家都是从麻瓜做起的，一个真正的新手也许连怎么搜索或在哪找`FAQ`都不知道。回复别人 `STFW` 合理但不合情。 - **没有十足把握，就别信誓旦旦** 一个听起来权威的斩钉截铁的**错误回复**比没有回复还要糟，不要随意许诺，信誓旦旦地说“就是这的问题”。时刻记住，谦受益,满招损。 - **可以不帮忙，但别瞎闹**。 不要在具体步骤上开玩笑，有些可怜的麻瓜真的会把 `rm -rf /*` 当成重启指令。 - **探索性的反问以启发提问者打开思路**。 授人以鱼，不如授人以渔。探索性的反问、讨论比直接给出答案更难能可贵。 - **从中发现自己软件的不足**。当回复一个好问题时，问问自己 『如何修改程序或 `FAQ` 文档以免再次解答同样的问题？』。 - **过程比结果更重要**。如果你自己也是研究了很久之后才得到答案，那在回复他人时，不仅回复其然，最好是能回复其所以然。这个过程才是真正的价值所在。 *** 对《[How To Ask Questions The Smart Way](http://www.catb.org/~esr/faqs/smart-questions.html)》原文感兴趣的可以直接阅读英文版，也可以参考 GitHub 上这篇[中文翻译](https://GitHub.com/ryanhanwu/How-To-Ask-Questions-The-Smart-Way/blob/main/README-zh_CN.md)。