当前位置:首页 > 文章列表 > 文章 > 前端 > 整洁的代码摘要

整洁的代码摘要

来源:dev.to 2024-12-13 14:58:04 0浏览 收藏

大家好,今天本人给大家带来文章《整洁的代码摘要》,文中内容主要涉及到,如果你对文章方面的知识点感兴趣,那就请各位朋友继续看下去吧~希望能真正帮到你们,谢谢!

整洁的代码摘要

如果代码可以被团队中的每个人轻松理解,那么代码就是干净的。干净的代码可以由原作者以外的开发人员阅读和增强。可理解性带来了可读性、可更改性、可扩展性和可维护性。
一般规则

  • 遵循标准约定。
  • 保持简单愚蠢。越简单总是越好。尽可能降低复杂性。
  • 童子军规则。让露营地比您发现时更干净。
  • 始终找到根本原因。始终寻找问题的根本原因。

设计规则

  1. 将可配置数据保持在较高水平。
  2. 更喜欢多态而不是 if/else 或 switch/case。
  3. 独立的多线程代码。
  4. 防止过度配置。
  5. 使用依赖注入。
  6. 遵循德墨忒尔法则。一个类应该只知道它的直接依赖关系。

可理解性提示

  1. 保持一致。如果你以某种方式做某事,那么所有类似的事情也以同样的方式做。
  2. 使用解释变量。
  3. 封装边界条件。边界条件很难跟踪。将它们的处理放在一个地方。
  4. 优先选择专用值对象而不是原始类型。
  5. 避免逻辑依赖。不要编写依赖于同一个类中其他内容而正确工作的方法。
  6. 避免否定条件。

命名规则

  1. 选择描述性且明确的名称。
  2. 进行有意义的区分。
  3. 使用可发音的名称。
  4. 使用可搜索的名称。
  5. 用命名常量替换幻数。
  6. 避免编码。不要附加前缀或类型信息。

函数规则

  1. 小。
  2. 做一件事。
  3. 使用描述性名称。
  4. 喜欢更少的争论。
  5. 没有副作用。
  6. 不要使用标志参数。将方法拆分为几个独立的方法,这些方法可以在不带标志的情况下从客户端调用。

评论规则

  1. 始终尝试用代码来解释自己。
  2. 不要多余。
  3. 不要添加明显的噪音。
  4. 不要使用右大括号注释。
  5. 不要注释掉代码。只需删除即可。
  6. 用作意图解释。
  7. 用作代码说明。
  8. 用作后果警告。

源代码结构

  1. 垂直分隔概念。
  2. 相关代码应垂直密集显示。
  3. 声明接近其用法的变量。
  4. 依赖函数应该关闭。
  5. 类似的功能应该很接近。
  6. 将函数放在向下的方向。
  7. 保持简短。
  8. 不要使用水平对齐。
  9. 使用空格来关联相关事物并分离弱相关事物。
  10. 不要破坏缩进。

对象和数据结构

  1. 隐藏内部结构。
  2. 更喜欢数据结构。
  3. 避免混合结构(一半对象和一半数据)。
  4. 应该很小。
  5. 做一件事。
  6. 少量实例变量。
  7. 基类应该对其派生类一无所知。
  8. 拥有许多函数比将一些代码传递到函数中来选择行为更好。
  9. 优先选择非静态方法而不是静态方法。

测试

  1. 每个测试一个断言。
  2. 可读。
  3. 快。
  4. 独立。
  5. 可重复。

代码味道

  1. 刚性。软件很难改变。一个小小的改变会导致一连串的后续改变。
  2. 脆弱。由于一次更改,该软件在许多地方出现故障。
  3. 一动不动。您无法在其他项目中重复使用部分代码,因为涉及风险和工作量。
  4. 不必要的复杂性。
  5. 无需重复。
  6. 不透明度。代码很难理解。

我想的就这么多,但还有更多。
请阅读整本书。

感谢您阅读总结,希望对您有所帮助。

网站:
https://kaleemelahi.co

给我买一杯咖啡:
https://buymeacoffee.com/kaleemelahi

今天带大家了解了的相关知识,希望对你有所帮助;关于文章的技术知识我们会一点点深入介绍,欢迎大家关注golang学习网公众号,一起学习编程~

版本声明
本文转载于:dev.to 如有侵犯,请联系study_golang@163.com删除
国内最大规模双膜法海水淡化工程在天津正式通水运行,每天生产 15 万吨国内最大规模双膜法海水淡化工程在天津正式通水运行,每天生产 15 万吨
上一篇
国内最大规模双膜法海水淡化工程在天津正式通水运行,每天生产 15 万吨
保护隐私:如何为电脑屏幕设置密码?
下一篇
保护隐私:如何为电脑屏幕设置密码?
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    542次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    508次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    497次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    484次学习
查看更多
AI推荐
  • 笔灵AI生成答辩PPT:高效制作学术与职场PPT的利器
    笔灵AI生成答辩PPT
    探索笔灵AI生成答辩PPT的强大功能,快速制作高质量答辩PPT。精准内容提取、多样模板匹配、数据可视化、配套自述稿生成,让您的学术和职场展示更加专业与高效。
    24次使用
  • 知网AIGC检测服务系统:精准识别学术文本中的AI生成内容
    知网AIGC检测服务系统
    知网AIGC检测服务系统,专注于检测学术文本中的疑似AI生成内容。依托知网海量高质量文献资源,结合先进的“知识增强AIGC检测技术”,系统能够从语言模式和语义逻辑两方面精准识别AI生成内容,适用于学术研究、教育和企业领域,确保文本的真实性和原创性。
    41次使用
  • AIGC检测服务:AIbiye助力确保论文原创性
    AIGC检测-Aibiye
    AIbiye官网推出的AIGC检测服务,专注于检测ChatGPT、Gemini、Claude等AIGC工具生成的文本,帮助用户确保论文的原创性和学术规范。支持txt和doc(x)格式,检测范围为论文正文,提供高准确性和便捷的用户体验。
    38次使用
  • 易笔AI论文平台:快速生成高质量学术论文的利器
    易笔AI论文
    易笔AI论文平台提供自动写作、格式校对、查重检测等功能,支持多种学术领域的论文生成。价格优惠,界面友好,操作简便,适用于学术研究者、学生及论文辅导机构。
    50次使用
  • 笔启AI论文写作平台:多类型论文生成与多语言支持
    笔启AI论文写作平台
    笔启AI论文写作平台提供多类型论文生成服务,支持多语言写作,满足学术研究者、学生和职场人士的需求。平台采用AI 4.0版本,确保论文质量和原创性,并提供查重保障和隐私保护。
    41次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议隐私政策
返回登录
  • 重置密码