基于干净代码的变量命名
来源:dev.to
时间:2024-12-30 10:49:05 235浏览 收藏
文章小白一枚,正在不断学习积累知识,现将学习到的知识记录一下,也是将我的所得分享给大家!而今天这篇文章《基于干净代码的变量命名》带大家来了解一下##content_title##,希望对大家的知识积累有所帮助,从而弥补自己的不足,助力实战开发!
干净代码是一组多种代码约定,它们共同创建了一种编写代码的新方式,使其更具可读性、可维护性、可靠性和可预测性,从而提高效率并促进团队合作。
干净代码的几个原则之一是使用自描述和不言自明的名称来命名变量,以避免歧义并编写更干净的代码,一位伟大的作家 zeno rocha 在他的书中说道 高生产力的 14 个习惯开发人员 我们应该始终编写未来的自己即使在多年后也能理解的代码。使用缩写或缩写命名变量可能会导致不同的解释,特别是在项目参与程度不同的开发人员之间,这可能会导致未来的问题。
随着代码库的增长并且其变量被搁置,将来需要重新访问它,而糟糕的编写将导致很难理解您的代码,这是很常见的。
不良变量的示例:
const date = new date() // nome da varável é muito genêrica e não explica o que ela é
function getdata(req, res) {} // nâo descreve bem o dado que ela está requisitando
好的变量的例子:
const currentdate = new date() // nome mais explicativo sobre o que ela é e menos genêrico
function getusergithubcategory(req, res) {} // descreve melhor o dado que a função está requisitando
仍然按照编写有意义的变量名称的相同逻辑,我们遇到了另一个重要的点,即在编写遵循相同编写方向的布尔变量时,但我们必须使用另一个累积到前一个的小规则。
她说如下,我们应该把布尔变量写成某种可以回答是或否的问题,这是因为布尔变量只能接收 true (是) 或 false (否) 和一个问题说出它们是否活跃有助于代码阅读。
不应用规则的示例:
const ticketpark = user.ticketpark if (!ticketpark ) { throw new error('o marcos não possui um bilhete para entrar no parque!') }
应用规则的示例:
const hasuserticket = user.hasticket // o usuário tem o ticket ? if (!hasuserticket) { // se o usuário não tiver o ticket throw new error('o marcos não possui um bilhete para entrar no parque!') }
你是否同意我的观点,当使用这种命名布尔变量的模型时,如果用户有票,他就可以去乘车,而不是仅仅检查公园票是否没有,这并没有让阅读变得更简单伪造的? 使用这些类型确实可以提高第三方对您的代码的理解,并帮助您避免歧义。
最后,我们还有一个与最后两条规则相伴的简单规则,除了更好地编写代码之外,还可以使用变量来存储代码中的“幻数”。但毕竟,代码中的这些神奇数字是什么? 通常,许多程序员在将业务规则应用到他们的项目时,会使用各种数字来执行代码中的某些操作,然后将这些操作扔到代码中,而不必解释它们为什么在那里。
充满幻数的代码示例:
function calculateshippingcost(distance: number, weight: number): number { if (distance < 100) { return weight * 5; } else if (distance < 500) { return weight * 10; } else { return weight * 15; } } const cost = calculateshippingcost(250, 20); console.log(`custo do frete: $${cost}`);
你能明白代码的用途吗?
这些难以形容的数字很难吧?
你有没有听过这句话“我不知道为什么如果你删除代码会破坏”?它很好地表达了我在这里想说的,避免让这些数字松散并且没有解释它们为什么在那里,如果不可能在变量中明确说明,请在代码中进行简单的注释。
看看这段代码应该怎么写:
// Constantes para faixas de distância const SHORT_DISTANCE_THRESHOLD = 100; const MEDIUM_DISTANCE_THRESHOLD = 500; // Constantes para taxas de frete const SHORT_DISTANCE_RATE = 5; // $5 por kg const MEDIUM_DISTANCE_RATE = 10; // $10 por kg const LONG_DISTANCE_RATE = 15; // $15 por kg function calculateShippingCost(distance: number, weight: number): number { if (distance < SHORT_DISTANCE_THRESHOLD) { return weight * SHORT_DISTANCE_RATE; } else if (distance < MEDIUM_DISTANCE_THRESHOLD) { return weight * MEDIUM_DISTANCE_RATE; } else { return weight * LONG_DISTANCE_RATE; } } const cost = calculateShippingCost(250, 20); console.log(`Custo do frete: $${cost}`);
现在好多了,对吧?
好处
采用清晰命名变量、避免幻数以及遵循干净代码原则等做法不仅可以提高代码质量,而且还可以更轻松地与其他开发人员协作并进行长期维护。
记住:编写干净的代码并不是为了达到完美,而是为了让代码对于每个使用它的人(包括将来的您)来说更易于访问、理解和预测。
尝试将这些规则应用到您的下一个项目中并注意其中的差异!与同事或您的团队分享这些技巧,以创建一个更加高效的工作环境。毕竟,编写良好的代码是构建高质量软件的第一步。
那么,从今天开始怎么样?编写您将来会自豪地阅读的代码!
理论要掌握,实操不能落!以上关于《基于干净代码的变量命名》的详细介绍,大家都掌握了吧!如果想要继续提升自己的能力,那么就来关注golang学习网公众号吧!
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
261 收藏
-
443 收藏
-
318 收藏
-
201 收藏
-
276 收藏
-
363 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 542次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 507次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 497次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 484次学习