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

整洁的代码摘要

来源: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基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • ljg-skills -
    ljg-skills
    ljg-skills 是李继刚开源的 AI 技能与提示词集合,面向大模型使用者整理了一批可复用的 prompt、角色设定和任务技能模板,适合用于学习提示词设计、搭建个人 AI 工作流和沉淀团队常用智能体能力。
    2036次使用
  • MELO音乐 - AI 音乐生成平台,支持多模态创作能力
    MELO音乐
    MELO音乐是一站式AI视频与音乐制作助手,对标suno, udio的高品质体验。提供伴奏生成、原创写词、无损导出、哼唱识曲、混音变声等全套音频与短视频编辑工具。无论是流行Kpop、电音说唱、民谣古风、摇滚儿歌还是商用轻音乐,MELO为你免费谱曲,轻松做同款!
    1892次使用
  • UniScribe - AI 免费在线音视频转文字平台
    UniScribe
    UniScribe 是一款 AI 音视频转文字与内容整理工具,支持上传音频、视频文件或粘贴 YouTube 链接,自动生成转写文本、摘要、思维导图和关键问题,并支持多格式导出,适合会议记录、课程学习、访谈整理和内容创作复盘。
    1828次使用
  • 剧云 - 免费 AI 智能中文剧本创作平台
    剧云
    剧云是专业中文剧本创作平台,安全稳定运行十余年,集成AI编剧、剧本医生审核、人物小传、剧情关系图、大纲编写、多人协作、Word导入导出、版权管控功能,数据安全防护,轻松高效创作剧本。
    2037次使用
  • 万象有声 - AI 一站式有声内容创作平台
    万象有声
    万象有声,一个专为有声创作者打造的新一代智能有声内容创作平台。平台提供专业的智能拆章、智能画本编辑、AI配音、AI生成音效、后期制作、智能对轨、智能审听等有声创作全流程工具,可以帮助创作者高效、低成本创作出引人入胜的有声作品。立即体验,让有声书制作更简单!
    2020次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议隐私政策
返回登录
  • 重置密码