《代码整洁之道》

本文阐述了整洁代码的重要性,探讨了混乱代码带来的低生产力、维护困难及态度问题。详细讲解了整洁代码的标准,包括细节关注、单一职责原则及简洁性。并通过命名、函数设计等方面指导如何实践整洁代码。

一、为什么要整洁代码

首先代码呈现了需求的细节,在某些层面上无法被抽象和忽略,所以代码会一直跟随我们。

为什么要整洁代码?如果我们不要整洁代码,会出现哪些问题:

(一)生产力低:当代码很混乱的时候,生产力是会下降。(做项目)

(二)维护:当代码混乱是很难去维护,自己无法理清,别人看不懂。当问题爆发以后无法去管理代码,而其他人也无法解决话优化代码。

(三)态度:混乱的代码归根结底反映出了我们对于代码的不在意。

根绝以上出现的问题,我们要整洁代码。

二、什么是整洁代码

    细节(内存泄露、前后不一致的命名、竞态条件代码)、只做好一件事(意图坚定,目标明确)(比如有一个函数函数名是验证用户,但是里头却有注销session。这样有的人使用这个函数就会导致错误)、简洁(在书写代码的时候应该尽可能的干净利落,讲究事实,不引人猜忌,让人明白自己的意图。)不要有重复代码

三、怎样做到整洁代码

 命名

    (一)命名时应该根据具体含义、功能去命名。可以说名字已经让不了解函数变量和类的人知道,你这个的功能是什么。避免代码的模糊。

    (二)尽量不使用关键字。比如LIST(代表一组)。这个就不要使用了。字母I(大写),小写(l),大小写(o)

    (三)对于名字,应该慎重一些,不要为了避免重名,随便起名字。比如什么a1,a2,a3……

    (四)名字应该起的能够读出来。

    (五)名称长度应该与其作用域大小相对应。比如短方法的本地变量可以使用单字母,但是如果这个变量代码多个地方使用内么应该根据其所代表的功能和含义起名。这样既可以方便理解也便于搜索。

    (六)尽可能不要使用前缀去标识成员变量,应该将类和函数做的足够小。

    (七)接口和实现

    (八)类名和对象名:名词和名词短语,方法名:动词和动词短语

    (九)每个概念对应一个词,比如控制层:controller。而且不要一个词代表不同含义。add:增加或连接两个现存值来获得新值。add将参数加入到集合。

    (十)1:计算机领域或者根据项目的领域起名字。2:起的名字尽量符合语境。

函数:函数越短小、功能越集中、就越能起个好名字

    (一)函数应该短小

    (二)函数应该做一件事,做好一件事。

    (三)每个函数一个抽象级

    (四)函数参数优先顺序,没有、一个……应避免三个。可以试试类里的私有变量。参数太多,对测试不太友好,因为参数太多,测试覆盖多有可能值的组合太多。(?)

            1、一元函数的普遍形式:传入单个参数一般有两种理由:1操作该函数,将其转换为其他什么东西,再输出。有输入参数,有输出参数2:表示事件。有输入参数而没有输出参数。比如:使用该参数修改系统状态。另外,参数和函数名最好形成一种联系。比如writeField(name),name这个将被write

            2、二元参数的普遍形式:尽量编写长一元函数。

    (五)抽离try/catch代码块。最好把try和catch代码块的主体部分抽离出来另外形成函数

小结:

    单元测试,分解函数、修改名称、消除重复、缩短和重新安置方法,还可以拆解类。

感悟:

起名字的重要性

try/catch

基于STM32 F4的永磁同步电机无位置传感器控制策略研究内容概要:本文围绕基于STM32 F4的永磁同步电机(PMSM)无位置传感器控制策略展开研究,重点探讨在不依赖物理位置传感器的情况下,如何通过算法实现对电机转子位置和速度的精确估计与控制。文中结合嵌入式开发平台STM32 F4,采用如滑模观测器、扩展卡尔曼滤波或高频注入法等先进观测技术,实现对电机反电动势或磁链的估算,进而完成无传感器矢量控制(FOC)。同时,研究涵盖系统建模、控制算法设计、仿真验证(可能使用Simulink)以及在STM32硬件平台上的代码实现与调试,旨在提高电机控制系统的可靠性、降低成本并增强环境适应性。; 适合人群:具备一定电力电子、自动控制理论基础和嵌入式开发经验的电气工程、自动化及相关专业的研究生、科研人员及从事电机驱动开发的工程师。; 使用场景及目标:①掌握永磁同步电机无位置传感器控制的核心原理与实现方法;②学习如何在STM32平台上进行电机控制算法的移植与优化;③为开发高性能、低成本的电机驱动系统提供技术参考与实践指导。; 阅读建议:建议读者结合文中提到的控制理论、仿真模型与实际代码实现进行系统学习,有条件者应在实验平台上进行验证,重点关注观测器设计、参数整定及系统稳定性分析等关键环节。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值