中、小型web项目开发工作经验总结---持续更新

╰+哭是因爲堅強的太久メ 2024-04-17 21:28 51阅读 0赞

2019-06-27

开发中自己坚持的准则是在实现代码功能的前提下，坚持写干净、简洁的代码，并且一定要写必要的注释。写代码的核心思想是：代码首先是先给人看的，其次才是拿去给机器执行的。每次写代码时，都会认真考虑，假如自己离职了，别人来维护我的代码时，他能看得懂吗？如果一个和自己同等水平的人不能很好的看懂自己写的代码，那我会视这些代码为垃圾代码，永远不写只有自己才能看得懂的代码，这样可以大大地减少别人在背后咒骂自己的次数。曾在网上看过一篇文章，说是腾讯的开发人员，写100行代码，则需要写50行左右的注释，真实性不好验证，可是这足以说明写注释的必要性。

.1.如果程序中需要自己主动抛出可能存在的异常，则不需要在抛出异常后再继续写return的代码。

.2.在页面中写JavaScript代码时，如果有提示信息(如保存成功)，则直接使用return返回封装的函数提示信息。

说明：这是JavaScript独有的语法，可以返回可执行的函数。

.3.异常捕获：路由model控制中必须进行try/catch处理，其他的如service、dao中可以不进行异常捕获，因为异常可以传递。如a方法调用b方法，b方法调用c方法，只需要在a中使用try/catch捕获c方法中抛出的异常即可。js中主动抛出异常的方式为throw new Error('错误信息');需要注意的是，主动抛出的异常信息一定要能够在catch中可以正常的输出、打印出来才行，这样便于错误信息的传递。当使用 throw ‘错误信息’ 跑出异常时，抛出的错误的信息是一个字符串；而使用throw new Error('错误信息')抛出的是一个对象，可以使用error.msssage来获取错误信息。

.4.提示信息：在model路由控制中，如果出现异常，则必须打印输出异常信息，有错误日志记录的添加日志记录，这样便于排错。

.5.一个ajax请求至少要有二个提示信息：第一个是发送请求失败的提示信息；第二个请求成功，可是后台处理失败的提示信息；如果是增加、删除等操作，操作成功时还需要有提示信息，如果出现错误时，这样处理便于排除错误。

.6.如果for循环中需要多次使用一个变量，则在for循环外定义，每次循环操作时改变变量的值，这样不用每次都创建变量；同理遍历数组时的长度也可以固定下来，避免每次循环时都需要求一次长度。

for(let k = 0,klen = arr.length; k < klen; k++)\{...\}

.7.后台获取变量值的时候采用这种方式let temp = obj.abc || ''，如果没有取到值则会将这个值设置为空字符串。

页面中使用jquery获取值的时候，使用let $value = ($('\#id').val() || '') + '').tirm(); 这种方式。如果没有值则将其值设置为空字符串，有值则先将其转换为字符串(加号是最快的方式)，最后去除空格。

.8.数据展示时如果某一列数据有多个值，比如性别有男/女，则在使用时需要对这一列的每一个值都做判断，可以使用三元表达式。let str = gender === '1' ? '男':(gender === '2' ? '女' : '数据错误');

如果类型非常多就使用循环，当获取的值不再这个区间时则给出错误提示，比如数据错误这样的提示。

.9.关于后台中的文字描述信息想写几点注意事项。新增，修改，删除统一命名为XX操作；普通的查询操作命名为XX查询;数据列表查询操作统一命名为XX列表查询；发送短信、重置密码等特殊的操作直接使用原始命名。这样命名别人一看都能够看明白，不会产生歧义，减少出错误的概率。

.10.如果需要判断某一个传入的参数信息，则只需要判断一次即可，如判断手机号码使用正则表达式判断一次即可。还有判断查询结果判断一次即可，如判断结果是否存在，长度是否等于0，结果中的数据是否等于某个值等等判断一次即可。

.1.校验时不管是在前台校验或者是在后台校验，能够采用正则表达式的最好采用正则表达式校验一次即可。可能话最后在后台做一次校验在进行下一步操作，别相信用户按照自己设计的逻辑来操作。

.2.2019-09-05//项目中有可能对文件进行操作或者是文件夹进行操作时，比如做删除操作，则一定要先判断文件或者是文件夹是否存在，存在则进行操作，不存在则不进行操作。今天修改一个辞职了的同事的代码，大多都是这种问题，没有对文件或者文件夹进行操作，结果是各种报错。还有一点需要注意，在对路径进行拼接的时候，Node中最好使用path.join(path1,path2,path3)进行拼接，因为在windows中和linux中，路径的表示方法是不一样的，join这个方法可以更具不同的系统自动进行不同的拼接，不会出错。如果使用字符串进行拼接，则很有可能出错。

.3.操作MySQL数据库时，如果是做删除操作，则表名一定不能使用别名。这条经验是来自于实践经验，由于删除时有许多限制条件，想使用别名来操作方便一些，可是实际操作时一直报错，最后去看各种博文才知道对数据表做删除操作时不能使用别名。

.4.写一个好的注释的必要性。2019-09-09，今天去修改自己自己半年前写的代码，突然发现自己看不懂了。定义一个变量虽然使用很少，可是自己怎么都想不起来它到底是用来 干什么用的，反反复复的看了很久都没回忆起来，只能想新办法解决。这说明写一个好的注释是多么的重要。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2Rlbmd5aWxhbmcxMjM_size_16_color_FFFFFF_t_70][]

.5.对于某段代码需要进行测试，不知道其怎么修改最合适的时候，则最好单独写一个测试文件，测试通过后再把代码复制到需要的地方去。如下面这段代码，我测试了有十几次才得到自己想要的代码。如果在项目中进行测试，没错一次就需要重新启动一次项目，然后重写登录，则不知道需要花多久时间才能够得到自己想要的代码。这就是单独写测试文件用于测试某段代码的重要性，可以大大地提升自己的开发效率，节约大量的时间。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2Rlbmd5aWxhbmcxMjM_size_16_color_FFFFFF_t_70 1][]

.6.2019-11-13项目中的某个页面分为左右两块，左边的先加载，右边的后加载，可是右边那一块的高度需要和左边保持一致，根据左边的高度来进行设置。我一开始的做法是使用setTimeout()函数，当页面加载220秒后再设置右边模块的高度。尝试了几次发现这样操作不行，返回测试后，改为使用setInterval()函数，10毫秒执行一次，当获取到的左边的模块有值时，设置右边模块的高度，然后停止执行定时函数。这样页面加载时，看上去像是同时加载的，效果很好。从这里可以得到一点，解决问题时思路很重要，如果有一个好的思路，那么解决问题会很快找到方法。

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2Rlbmd5aWxhbmcxMjM_size_16_color_FFFFFF_t_70]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/17/244cdbde918e4a11a7f5db80dff6f565.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2Rlbmd5aWxhbmcxMjM_size_16_color_FFFFFF_t_70 1]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/17/b5c4d95524db420082f02b1b49572c08.png