代码规范&设计模式落地之路

S7-1200模拟量 将两种不同的金属或合金金属焊接起来,构成一个闭合回路,利用温差电动势来测量温度,当两端存在温度梯度时,回路中就会有电流通过,此时两端之间就存在电动势--热电动势,这就是所谓的塞贝克效应(seebeck effect)。温差越大,热电动势越高。热电偶是有正负极性的,所以需要确保导线连接到正确的极性,否则会造成明显的测量误差。为了使温度补偿达到最佳效果,必须将热电偶模块安装在温度稳定的环境中简述:两种金属,每一种金属随温度变化是不同的,出现温差--由俩金属构成的回路就会有电流经过,因此两端形成热电动势。 阅读详情

点击上方“芋道源码”,选择“设为星标”

管她前浪,还是后浪?

能浪的浪,才是好浪!

每天 10:33 更新文章,每天掉亿点点头发...

源码精品专栏

 

来源:juejin.cn/post/6844904142960328718


前言

刚刚与同事开了一个分享会,笔者分享了一些了代码设计模式 相关的内容。

以及复盘了一下项目中有些复杂的业务场景,为什么没有很好的应用到设计模式 。

业务虽然肯定保密的,但是抛开项目 ,业务 层面,纵观回顾了一下笔者以往的项目,关于设计模式 和代码规范 问题还是有一些内容还是值得落笔和大家分享的。

推荐下自己做的 Spring Boot 的实战项目:

https://github.com/YunaiV/ruoyi-vue-pro

正文

设计模式究竟是什么?

主流的说法,大致如此:

设计模式是解决可在许多不同情况下使用的问题的描述或模板,一般在OOP中最作为最佳实践的解决方案。

最佳实践一词笔者在几处介绍设计模式的地方,都有看到。但是设计模式真的就是OOP中,业务开发的最佳实践吗?

首先声明笔者的观点,我是如何理解设计模式的:

设计模式是一种代码规范,不同于空格 ,缩进 这类容易被插件检测的入门规范,是一种中级代码规范 ,不宜被入门者理解,不易被插件所检测。

所以笔者认为设计模式 是属于代码规范 级别的,能不能成为最佳实践 ,也要看使用者。

设计模式在常规业务开发的存在感

常常在网上能看到,很多人晒自己碰到的“祖传代码”,“龟派气功式代码”,“shǐ山代码”等等。

我们不是有设计模式吗?不是有代码规范吗?

图片

幸存者偏差是一部分原因,只有烂代码才会被挂出来让人吐槽。

综合来看这种情况还是很多,那么是如何造成这种局面的,难道是这届程序员水平不行?

代码规范性或使用设计模式的痛点

笔者首先复盘了一些在业务开发 中为什么不能很好应用设计模式 的因素。

性能

在极端的考虑下,例如Java语言,设计模式面临着更多的类文件 以及更多的代码 。

在类加载和内存使用上的成本,自然是略微高于不使用设计模式。

但是也不能一概而论 ,有些设计模式(如:单例模式,享元模式等)就是为了提高性能 或节约资源 成本而出现的。

以及大多数情况下,良好的代码维护性优点要远远大于这点微小的性能开销,所以性能用了删除线。

类爆炸

虽然网上已经有各种设计模式的小Demo代码,但是还是可能会出现设计存在缺陷 ,过度设计 等情况。

复杂的设计模式,需要依靠业务建模,并不能拿来即用,甚至“生抄硬套 ”。

设计缺陷和过度设计,两者对开发人员都是一样痛苦的,会出现“不该用设计模式而用 ”,或者单纯为了”迎合缺陷的设计模式 ”,写出对应逻辑复杂的代码,这样类爆炸不可避免。

而且,就算正常使用的设计模式在业务复杂情况,类爆炸也不可避免。比如策略模式,如果业务情况就是有很多,你也必须把每个情况实现类写出来。

这就对开发的时间成本有一些细微的影响了。

甚至据笔者所知,有些传统公司 ,或者对日项目,几乎一个类要有一个Excel文档,详细说明类和其中元素的作用。

你可能和我想的一样,找个javadoc的api,逆向从注释生成Excel不就完了吗?

但实际上这类公司大多数还是靠人力 完成这些工作的,类的数量多了起来,对维护文档的人也是巨大挑战。

团队成员编码水平

在传统的软件公司,出于节约成本考虑,很难做到人员全部“高配”并且能够有自驱动的精神。

通常都是1拖N的人员配备,想让薪资寥寥的初级工程师就有“高内聚 ,低耦合 ,以及开闭原则 为代表的设计模式六大原则等”这类的设计思想,也是有点难为情。

此处说句题外话,

而且很多初级工程师其实对框架很“有适应性 ”的,当然并非真正的适应性 。

比如:如果代码里没有统一异常处理 ,那么时间长了你就会发现,到处都是自己的try catch。

再比如,项目里没有引入工具类库,那么时间长了你就会发现,到处都是网上奇怪的util类,甚至每个类中都有重复的工具方法。

这些不能算是初级工程师的问题,要归结于技术负责人 ,比如观察到了项目中还没有工具库,那么是不是应该先去公司内部的二方库 中寻找,如果没有是不是应该引入commons-lang3,hutool,guava这类的第三方优秀库等等。

项目大环境

我们生存在一个高度架构 为主的流量时代 。高并发,大流量,各种微服务,以及中间件建设等等已经是主流趋势。

那么代码层面的设计模式 以及代码规范性的地位,就有些微妙了。

笔者也见过不少项目,架构师只去考虑是不是该“加机器,加中间件,加配置”等上层建设。由于团队成员水平断档,对代码的要求几乎为0 ,也没有review等规则,能实现即可。

时间成本与敏捷开发

在敏捷开发场景,业务频繁变动,项目快速迭代,这当然也是因素之一。

比如常说的可以优化if else的策略模式 ,如果初期只有一个分支,你会用设计模式吗?那么需求变动加了一个呢?如果又加了一个呢?

什么时间点选择使用设计模式 优化代码,或者用不用优化 ,以及有没有时间优化 都是个问题。

通常有经验的工程师,一般不会说出“这不就一行代码嘛,一分钟改完”这样的话。

毕竟修改代码,要思考全局性 (是否其它代码也有相同修改需求),正确性 ,以及分支影响性 (是否影响其他逻辑的执行)。

甚至也有公司对覆盖率 和测试类 有要求,所以用打字速度判定需求落地速度,并不是业内人士的经验之谈。

这样时间成本也成为了一个因素。

人员流动

人员流动在互联网不是一个稀奇的事情。

一方面是公司原因 ,随着改革春风吹满地,已经到了遍地“老板”的年代,一些公司,要求不合理,甚至条款都是违fa行为导致人才流失。

二是个人原因 ,水平高为高薪所走,水平低被低薪劝退。

那么不管那种原因,在人员频繁流动下,代码质量要想做好,对管理上也是一种挑战。

毕竟如果你接手一个逻辑复杂的龟派气功代码 ,业务逻辑还没完全清晰的场景下,大多数人会老老实实的添加if else以完成需求。

分析

代码规范&设计模式重要吗?

上文列举了一些,在项目开发中代码规范 ,以及使用设计模式 上的一些痛点。

之所以称之为痛点 而不是缺点 ,原因就像上文有些场景,代码都不是重要的一环,代码规范更不值一提,何来缺点一说。

所以重不重要,综合上文来看,除了主观因素,团队因素,甚至还有团队管理者的原因。毕竟的确在一些场景,只是对开发人员友好,对KPI来讲毫无用处,导致了不重视。

如何持续做好代码规范

如果我们是有geek精神 的团队,或者要设计长时间维护的产品,还是建议做好代码规范和设计模式的落地。

那么就不妨从笔者总结的痛点上,结合自己当下场景逐条分析,取得一个“平衡 ”点。

笔者也大致总结了几点,以应对上面的措施,但每个人都有每个人的情况,和设计模式 本身一样,不能“生抄硬套”。

  • 深入理解业务,做好 业务预判 ,这样就为了底层设计打出良好基础。

  • 在保障人力成本的情况下,自驱性的成员在当今也不在少数,要给予信心一起做好基础建设 。

  • 复杂的业务点频繁迭代某个早期时刻 ,技术负责人需要切入,衡量工时分析业务,以便断定是否需要重构,或者出代码设计方案。

  • 人员频繁流动下,工作要尽量形成文档,不能以“走形式”为主,不仅要良好交接代码,还要良好交接业务。

  • 传统项目,对日项目要充分利用自动化工具,尽量多多代替人工的文档维护。

当然了,本文提到的痛点,在中小公司最不难发现,更不是三言两语就能解决,所以尽力做到平衡就非常好了。

如果不存在这些痛点,人员自驱性强,基础建设良好等。大概率是足够优秀的企业了,如果你是这样企业的员工,还坚持看到这里,那就当了解一下中小企业的小问题。

推荐下自己做的 Spring Cloud 的实战项目:

https://github.com/YunaiV/onemall

结尾

刚入行时,笔者也曾看着历史代码发出笑声,“这么乱的代码,怕是喝了散装假酒”。

时过境迁,随着工作年限的增长,看问题的角度也在不断发生变化,现在不仅不会发出嘲笑了,还总结了乱代码出现的原因。

关于设计模式 和代码规范 方面的思考也有了新的理解,也如上文所说,碰巧与同事开会提到了,所以整理成文。

文章的标签设置为阅读下的“代码规范”,因为本文没有技术干货,算是经验分享,希望对你有所帮助。

- END -

欢迎加入我的知识星球,一起探讨架构,交流源码。加入方式,长按下方二维码噢:

已在知识星球更新源码解析如下:

最近更新《芋道 SpringBoot 2.X 入门》系列,已经 101 余篇,覆盖了 MyBatis、Redis、MongoDB、ES、分库分表、读写分离、SpringMVC、Webflux、权限、WebSocket、Dubbo、RabbitMQ、RocketMQ、Kafka、性能测试等等内容。

提供近 3W 行代码的 SpringBoot 示例,以及超 4W 行代码的电商微服务项目。

获取方式:点“在看”,关注公众号并回复 666 领取,更多内容陆续奉上。

文章有帮助的话,在看,转发吧。
谢谢支持哟 (*^__^*)
从原理图到PCB:手把手教你绘制DRV8301驱动板(附完整代码与避坑指南) 本文详细介绍了如何从原理图设计到PCB布局,手把手教你绘制DRV8301驱动板,特别适用于FOC(磁场定向控制)系统开发。内容涵盖元器件选型、电源树架构设计、栅极驱动电路、PCB布局技巧、焊接调试及代码配置,并附有完整代码与常见问题避坑指南,帮助工程师快速掌握DRV8301驱动板的设计与优化。 阅读详情

相关推荐

避坑指南:HslCommunication连接西门子PLC时常见的5个错误及解决方法(S7-1200/S1500适用)

本文详细解析了使用HslCommunication连接西门子S7-1200/S1500 PLC时常见的5个错误及解决方法,包括基础连接配置、数据块读写异常、连接闪断、防火墙与权限问题以及高级调试技巧。通过实战案例和代码示例,帮助开发者快速定位和解决连接问题,提升工业自动化项目的开发效率。

weixin_30752699的博客 399

代码规范 & 设计模式落地之路

—1—前言与同事开了一个分享会,笔者分享了一些了代码设计模式相关的内容。以及复盘了一下项目中有些复杂的业务场景,为什么没有很好的应用到设计模式。业务虽然肯定保密的,但是抛开项目,业务层面,纵观回顾了一下笔者以往的项目,关于设计模式和代码规范问题还是有一些内容还是值得落笔和大家分享的。—2—正文设计模式究竟是什么?主流的说法,大致如此:设计模式是解决可在许多不同情况...

中生代技术 236

超详细流式细胞术全流程解析:从样本制备到结果分析全攻略

流式细胞术(Flow Cytometry)是现代生物学和医学研究中不可或缺的高通量分析技术,可实现对细胞表型、功能状态、细胞周期等多维度参数的快速检测。本文将从实验全流程出发,详解样本制备、上机操作、参数设置及结果处理的核心要点,帮助科研人员精准掌握流式实验关键技术。

good_rrrrr的博客 3871

代码规范+设计模式落地之路

前言 正文 设计模式究竟是什么? 设计模式在常规业务开发的存在感 代码规范性或使用设计模式的痛点 分析 代码规范&设计模式重要吗? 如何持续做好代码规范 结尾 前言 刚刚与同事开了一个分享会,我分享了一些了代码设计模式相关的内容。 以及复盘了一下项目中有些复杂的业务场景,为什么没有很好的应用到设计模式。 业务虽然肯定保密的,但是抛开项目,业务层面,纵...

phubing 375

深入解析音频信号处理的核心算法——傅里叶变换、语音增强、回声消除与主动降噪

本文系统介绍了现代音频信号处理的核心技术。首先阐述傅里叶变换作为理论基础的重要性,它能将声音分解为频域成分。随后重点分析三大关键技术:语音增强利用谱减法、维纳滤波和深度学习从噪声中提取人声;回声消除采用自适应滤波器消除通话中的回声;主动降噪通过声波干涉原理抵消环境噪声。文章最后指出,这些技术在实际应用中协同工作,形成完整的音频处理链路,共同提升语音质量和听觉体验。随着算法进步和算力提升,音频处理技术正向着更智能、更高效的方向发展。

程序猿老樊的博客 1331

StarRocks FE启动异常

服务器断电,StarRocks FE 启动失败。

qq_15138049的博客 1114

设计模式和代码规范落地之路

更多内容关注微信公众号:fullstack888前言关于设计模式和代码规范问题还是有一些内容还是值得落笔和大家分享的。设计模式究竟是什么?主流的说法,大致如此:设计模式是解决可在许多不同情...

qianshanding0708的博客 245

FastAPI 极简教程(偏实战,一篇搞定)

本文是一篇FastAPI实战教程,通过最少的概念讲解快速掌握FastAPI的核心功能。文章首先介绍FastAPI是基于Starlette和Pydantic的高性能Python API框架,具有自动生成文档、类型驱动校验、异步支持和依赖注入等优势。教程从安装环境开始,演示了如何创建最小项目并编写第一个"Hello World"接口。接着详细讲解了路由参数处理(Path/Query/Body)、Pydantic数据模型校验、响应模型控制、状态码设置等核心功能。在高级功能方面,重点介绍了错误处

AI天才研究院 822

16 条 yyds 的代码规范

本文总结了16条关键代码规范,涵盖命名、函数设计、注释、格式、错误处理、测试等多个方面。重点包括:命名要有意义且一致,函数应短小且单一职责,注释需解释意图而非重复代码,格式化要统一自动化,避免魔法值和重复代码,正确处理错误和异常,编写全面的单元测试。此外强调代码应简单清晰而非过度设计,恰当使用设计模式,合理优化性能,重视安全性。这些规范旨在提高代码的可读性、可维护性和可靠性,建议通过代码审查和工具自动化来落实规范。遵循这些原则能显著提升代码质量,降低团队协作成本。

油墨香^-^的博客 1026

29、几何形态测量学在蝴蝶翅膀研究中的应用

本博客介绍了几何形态测量学在花斑木蛱蝶(Pararge aegeria)翅膀研究中的应用,探讨了环境因素对蝴蝶翅膀大小和形状的影响。通过选择合适的地标并采用Procrustes分析方法,研究揭示了不同景观类型下翅膀形状的差异及其潜在的适应性意义。文章还讨论了发育可塑性在飞行形态变异中的作用,并比较了几何形态测量学与其他传统方法的优势。最后提出了未来研究方向,包括多因素综合分析、发育机制探索及长期生态监测,为理解蝴蝶的适应性进化提供了重要线索。

ff678的博客 109

嵌入式Zephyr RTOS面试题及参考答案

在Zephyr中,为自定义外设编写Devicetree绑定(Bindings)有助于内核理解设备树中自定义外设节点的含义和属性。首先,需要创建一个.yaml格式的绑定文件,通常存放在目录下对应的子目录中,文件名应能反映外设的类型和功能。绑定文件的开头要定义基本信息,包括字段,用于简要描述外设的功能和用途;compatible字段,它是一个字符串列表,用于匹配设备树中自定义外设节点的compatible属性,设备树节点和绑定文件通过这个字段关联起来。接下来,要定义外设节点的属性。使用properties。

大模型大数据攻城狮的专栏 988

自动驾驶C++工程化实战:从代码规范到设计模式的四大基石

在软件工程领域,构建大型复杂系统不仅需要精湛的算法,更离不开扎实的工程化能力。其核心原理在于通过一系列规范、工具和最佳实践,将代码从个人作品转变为可协作、可维护、可测试的工业级产品。这带来了显著的技术价值:提升团队开发效率、保障系统长期稳定、降低维护成本,并最终支撑起如自动驾驶、金融交易等对安全性和可靠性要求极高的关键应用场景。具体到自动驾驶这样的C++分布式系统,工程化实践尤为关键。本文聚焦于其中的四大核心支柱:命名与代码规范、Git代码管理、单元测试和设计模式。例如,通过**Clang-Format**

weixin_34094282的博客 242

从苏宁电器到卡巴斯基第02篇:我的本科时光(中)

怎么还分班了呢? 大概是在大二第二学期的时候吧,学院突然通知我们要分班。因为我们目前所有学生都是属于工商管理专业的,而从下个学期开始,就要分为会计、市场营销以及工商管理这三个方向。这还真是打了我一个措手不及,我都不知道还有分班这一回事。不过也没关系,我继续选择我的工商管理就好了。不过,在实际的选择结果上,像会计和工商管理这种学科,选的人自然是占了绝大多数,而选择市场营销的,大概也就是十

Gleam的专栏 9608
上一篇: 内存数据库及技术选型
下一篇: 又一款Nginx 管理可视化神器!通过界面完成配置监控,一条龙!
公众号-芋道源码
博客等级 码龄10年 1640粉丝 377原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明:

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

余额充值