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

整洁的代码摘要

来源: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推荐
  • ChatExcel酷表:告别Excel难题,北大团队AI助手助您轻松处理数据
    ChatExcel酷表
    ChatExcel酷表是由北京大学团队打造的Excel聊天机器人,用自然语言操控表格,简化数据处理,告别繁琐操作,提升工作效率!适用于学生、上班族及政府人员。
    3195次使用
  • Any绘本:开源免费AI绘本创作工具深度解析
    Any绘本
    探索Any绘本(anypicturebook.com/zh),一款开源免费的AI绘本创作工具,基于Google Gemini与Flux AI模型,让您轻松创作个性化绘本。适用于家庭、教育、创作等多种场景,零门槛,高自由度,技术透明,本地可控。
    3408次使用
  • 可赞AI:AI驱动办公可视化智能工具,一键高效生成文档图表脑图
    可赞AI
    可赞AI,AI驱动的办公可视化智能工具,助您轻松实现文本与可视化元素高效转化。无论是智能文档生成、多格式文本解析,还是一键生成专业图表、脑图、知识卡片,可赞AI都能让信息处理更清晰高效。覆盖数据汇报、会议纪要、内容营销等全场景,大幅提升办公效率,降低专业门槛,是您提升工作效率的得力助手。
    3438次使用
  • 星月写作:AI网文创作神器,助力爆款小说速成
    星月写作
    星月写作是国内首款聚焦中文网络小说创作的AI辅助工具,解决网文作者从构思到变现的全流程痛点。AI扫榜、专属模板、全链路适配,助力新人快速上手,资深作者效率倍增。
    4546次使用
  • MagicLight.ai:叙事驱动AI动画视频创作平台 | 高效生成专业级故事动画
    MagicLight
    MagicLight.ai是全球首款叙事驱动型AI动画视频创作平台,专注于解决从故事想法到完整动画的全流程痛点。它通过自研AI模型,保障角色、风格、场景高度一致性,让零动画经验者也能高效产出专业级叙事内容。广泛适用于独立创作者、动画工作室、教育机构及企业营销,助您轻松实现创意落地与商业化。
    3816次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议隐私政策
返回登录
  • 重置密码