今天,我们来说说程序员常犯的5个错误:错误一:没有文档所有项目的第一个错误就是:没有文档。没有文档,你如何开始?您如何理解项目结构、软件架构以及在哪里可以找到您要修改和更新的文件?文档是项目成功的关键。无论它是否开源,您都需要确保记录如何使用项目、如何测试和部署项目。还有一些很好的项目可以帮助您处理文档,例如docusaurus。错误2:注释即使您有文档,您仍然需要理解代码,即使您是自己编写代码,您仍然可能不记得一段特定的代码在做什么,或者它是如何使用的,并且当然,你不需要为函数intaddToNumbers(intv1,intv2)写注释,但是你可能需要为函数computeQuotaForUser(intuserId)添加一些注释,比如当代码不明显或者当多个键码不明显或在多个键码路径上使用时注释。错误3:不可读的代码您是否曾经花数小时阅读一段代码并理解它的作用(尤其是没有注释),每个开发人员都有这样的经历。所以,你要确保你的代码是可读的,不仅要在不明显的代码上添加注释,还要在整个代码库中采用一致的风格。例如,如何命名变量(例如,像timeRemainingSeconds而不是timeremremaining),编写可以直接在屏幕上显示的短代码单元(大约40行左右)。错误4:不测试另一个最大的错误是从不进行任何单元或集成测试。当然,你手动测试了代码,你可以确定它会在你的机器上运行,但不能保证你的同事会运行相同的测试,也不能保证代码会在干净的环境中运行(比如作为CI/CD管道)。为确保您的代码顺利运行,请编写单元测试并在CI/CD管道中的每次更改时运行它们。错误5:尽量不要使用强类型许多语言,例如JavaScript或Python,不使用强类型。他们通过引入相应的类型(作为额外层的一部分——如TypeScript,以及作为可选模块的一部分——如Python)来解决这些问题。强类型会导致问题,一些开发人员仍在使用字符串和整数进行加法运算,例如“1”+1等于2(等于11)。这类问题往往很难发现,找到罪魁祸首就像大海捞针。为避免此类问题,请小心使用强类型并始终声明类型。
