整洁的代码摘要
来源:dev.to
时间:2024-12-13 14:58:04 473浏览 收藏
大家好,今天本人给大家带来文章《整洁的代码摘要》,文中内容主要涉及到,如果你对文章方面的知识点感兴趣,那就请各位朋友继续看下去吧~希望能真正帮到你们,谢谢!
如果代码可以被团队中的每个人轻松理解,那么代码就是干净的。干净的代码可以由原作者以外的开发人员阅读和增强。可理解性带来了可读性、可更改性、可扩展性和可维护性。
一般规则
- 遵循标准约定。
- 保持简单愚蠢。越简单总是越好。尽可能降低复杂性。
- 童子军规则。让露营地比您发现时更干净。
- 始终找到根本原因。始终寻找问题的根本原因。
设计规则
- 将可配置数据保持在较高水平。
- 更喜欢多态而不是 if/else 或 switch/case。
- 独立的多线程代码。
- 防止过度配置。
- 使用依赖注入。
- 遵循德墨忒尔法则。一个类应该只知道它的直接依赖关系。
可理解性提示
- 保持一致。如果你以某种方式做某事,那么所有类似的事情也以同样的方式做。
- 使用解释变量。
- 封装边界条件。边界条件很难跟踪。将它们的处理放在一个地方。
- 优先选择专用值对象而不是原始类型。
- 避免逻辑依赖。不要编写依赖于同一个类中其他内容而正确工作的方法。
- 避免否定条件。
命名规则
- 选择描述性且明确的名称。
- 进行有意义的区分。
- 使用可发音的名称。
- 使用可搜索的名称。
- 用命名常量替换幻数。
- 避免编码。不要附加前缀或类型信息。
函数规则
- 小。
- 做一件事。
- 使用描述性名称。
- 喜欢更少的争论。
- 没有副作用。
- 不要使用标志参数。将方法拆分为几个独立的方法,这些方法可以在不带标志的情况下从客户端调用。
评论规则
- 始终尝试用代码来解释自己。
- 不要多余。
- 不要添加明显的噪音。
- 不要使用右大括号注释。
- 不要注释掉代码。只需删除即可。
- 用作意图解释。
- 用作代码说明。
- 用作后果警告。
源代码结构
- 垂直分隔概念。
- 相关代码应垂直密集显示。
- 声明接近其用法的变量。
- 依赖函数应该关闭。
- 类似的功能应该很接近。
- 将函数放在向下的方向。
- 保持简短。
- 不要使用水平对齐。
- 使用空格来关联相关事物并分离弱相关事物。
- 不要破坏缩进。
对象和数据结构
- 隐藏内部结构。
- 更喜欢数据结构。
- 避免混合结构(一半对象和一半数据)。
- 应该很小。
- 做一件事。
- 少量实例变量。
- 基类应该对其派生类一无所知。
- 拥有许多函数比将一些代码传递到函数中来选择行为更好。
- 优先选择非静态方法而不是静态方法。
测试
- 每个测试一个断言。
- 可读。
- 快。
- 独立。
- 可重复。
代码味道
- 刚性。软件很难改变。一个小小的改变会导致一连串的后续改变。
- 脆弱。由于一次更改,该软件在许多地方出现故障。
- 一动不动。您无法在其他项目中重复使用部分代码,因为涉及风险和工作量。
- 不必要的复杂性。
- 无需重复。
- 不透明度。代码很难理解。
我想的就这么多,但还有更多。
请阅读整本书。
感谢您阅读总结,希望对您有所帮助。
网站:
https://kaleemelahi.co
给我买一杯咖啡:
https://buymeacoffee.com/kaleemelahi
今天带大家了解了的相关知识,希望对你有所帮助;关于文章的技术知识我们会一点点深入介绍,欢迎大家关注golang学习网公众号,一起学习编程~
声明:本文转载于:dev.to 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
最新阅读
更多>
-
304 收藏
-
233 收藏
-
110 收藏
-
238 收藏
-
367 收藏
-
205 收藏
课程推荐
更多>
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 542次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 507次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 497次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 484次学习