程序员正确的提问方式(个人建议)

前言

本文主要写给目前在我技术交流群里的同学。

为什么要正确提问?

对提问者而言,好处在于:

  • 更清晰地描述清楚自己的问题;
  • 问题得到解决的概率更大
  • 被提问者更愿意解答你的问题

对被提问者而言,好处在于:

  • 花的时间更少,去解决问题
  • 心情更舒畅点,更愿意去解决问题

怎么样才算是一个正确的提问方式,我的建议是,设身处地,仔细想想,假设自己是那个被提问的人,自己是那个要解决问题的人,需要提问者,提供什么样的东西,才能更好地解决问题?

这个大家其实工作中,学习中都会碰到,比如,你的同事要请教你一个问题,你问对方什么问题,对方支支吾吾说不清楚,你听不明白,这问题还能解决吗?

再想想,测试的同学提bug时,是不是好多就是图一贴就完事了,问题什么时候发生的,什么场景发生的,哪个用户触发的,这些信息完全没有,你说,你怎么解决?

我们这边的测试,每次就是贴图,也不说把出现问题的那个单号,用户id之类的复制出来,每次我们开发同学改bug,都要照着图去敲单号?你想不想吐槽?

扯了这么些,其实就是说,我们要尽量地,在职场,在生活中,去做一个靠谱的人,做一个同事喜欢的,愿意和你合作的人,和你合作起来很愉快的人。

以前,我问同事问题,也是qq里直接贴图,后来一个同事就和我说,贴文字啊,不然对方还要敲一遍。

恩,这就是同理心。

正确的提问,核心就是要有同理心。

下面说具体的,java工程的提问方式。

一、使用maven工程

先加个重点,请去掉target目录,那个很大,微信或者qq,传都要传半天,而且有时候是在手机收的文件,一般看问题肯定是电脑上,没有去掉target目录的话,一个工程,几十上百兆很正常,这时候,要把微信上收的文件,转到电脑,就要花几分钟。

java后端,以maven工程居多,所以,一般来说,一个标准的maven工程,长这样:

就是一个文件夹,然后里面一个pom,一个src文件夹。具体可以看下面的图(来自于网络:)

这样的maven工程,不管是什么ide,都是可以直接import的,这样的话,解答问题的人,拿到这个工程,可以直接导入自己的ide中。

如果是多模块聚合工程,一般长下面这样:

不知道怎么搭建聚合工程的话,可以看我以前的一篇文章,比较早了,写得一般,不过还是可以看看。大家也可以自行搜索。

https://www.cnblogs.com/grey-wolf/p/6606334.html

二、数据库sql

第二个要点,是工程涉及的sql脚本,一些问题可能不涉及数据库,那就算了。有的是,没有数据库,根本启动不了;或者,启动后,也没有数据,去进行问题的测试和复现,这时候,就必须提供sql脚本。

一般sql脚本格式如下:

  1. 建表sql

    CREATE TABLE `user` (
      `id` int(10) NOT NULL,
      `username` varchar(200) COLLATE utf8mb4_unicode_ci DEFAULT NULL,
      PRIMARY KEY (`id`)
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci
    
  2. insert等初始化数据的语句

    
    insert  into `user`(`id`,`username`) values (222,'ssss');
    
  3. 建库sql

    CREATE DATABASE /*!32312 IF NOT EXISTS*/`test` /*!40100 DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci */;
    
    

一般,以上sql,都可以直接通过navicat等工具生成。大家可自行搜索。

三、问题的复现步骤

一般来说,针对web工程,很多问题,都是通过api请求去触发,比如平时我们遇到的各种bug;少部分是定时任务等触发。

如果是请求触发,就需要提供:请求的接口,路径,参数是什么样的,因为不同的参数,可能一个能复现问题,一个就不能。

可以像下面这样提供:

我上面只是举个例子,大家不要用图片,尽量用文字,比如,如下的curl格式,就能完整展示请求的内容:

curl -i -X GET \
 'http://127.0.0.1:8080/gym_war_exploded/user/borrowEquipment.do?eqId=54383a62-0a45-46b6-b1b0-c1be58446a4f&userId=c5d759d9c8f8407992ded888eebaf19b'

四、尽量去掉无关因素

这个是加分项,前面第一点我说了,现在主要用maven工程,大家知道,下载依赖还是需要不少时间的。

很多时候,你给一个完整的工程过去,里面几十上百个依赖,对方下载都要下半小时。。。你说这怎么搞?

所以,大家尽量提供一份:能复现问题的最小工程。

简单就是,pom.xml里,不要大而全,尽量按需要来,这也是我平时工作中很注意的一个点,包少了,打包都快得多,启动也快得多,调试也快些(这时候可能需要加载或扫描的类、jar包就少了)。

五、其他

todo,其他待补充。

总结

有的同学觉得,我提个问题,也太麻烦了。当然,问题从来都不简单,尤其是,信息还不够的情况下。如果真心希望问题得到解决,那肯定是要花点时间的。

posted @ 2020-04-07 21:56  三国梦回  阅读(1503)  评论(4编辑  收藏  举报