首页 web前端 js教程 基于干净代码的变量命名

基于干净代码的变量命名

Dec 28, 2024 am 12:49 AM

Nomeação de variáveis baseada no clean code

干净代码是一组几种代码约定,它们共同创建了一种编写代码的新方式,使其更具可读性、可维护性、可靠性和可预测性,从而提高效率并促进团队合作.

干净代码的几个原则之一是使用自描述和不言自明的名称来命名变量,以避免歧义并编写更干净的代码,一位伟大的作家 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!')
}
登录后复制

你是否同意我的观点,当使用这种命名布尔变量的模型时,如果用户有票,他可以去乘车,而不是仅仅检查公园票是否没有,这并不会让阅读变得更简单伪造的? 使用这些类型确实可以提高第三方对您的代码的理解,并帮助您避免歧义。

最后,我们还有一个与最后两条规则相关的更简单的规则,除了更好地编写代码之外,还可以使用变量在代码中存储“幻数”。但毕竟,代码中的这些神奇数字是什么? 通常,许多程序员在将业务规则应用到他们的项目时,会使用各种数字来执行代码中的某些操作,然后将这些操作扔到代码中,而不必解释它们为什么在那里。

充满幻数的代码示例:

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 
登录后复制
登录后复制

现在好多了,对吧?

好处

采用清晰命名变量、避免幻数以及遵循干净代码原则等做法不仅可以提高代码质量,而且还可以更轻松地与其他开发人员协作并进行长期维护。

请记住:编写干净的代码并不是为了达到完美,而是为了让代码对每个使用它的人(包括将来的您)更易于访问、理解和预测。

尝试将这些规则应用到您的下一个项目中并注意其中的差异!与同事或您的团队分享这些技巧,以创建一个更加高效的工作环境。毕竟,编写良好的代码是构建高质量软件的第一步。

那么,从今天开始怎么样?编写您将来会自豪地阅读的代码!

以上是基于干净代码的变量命名的详细内容。更多信息请关注PHP中文网其他相关文章!

本站声明
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热AI工具

Undresser.AI Undress

Undresser.AI Undress

人工智能驱动的应用程序,用于创建逼真的裸体照片

AI Clothes Remover

AI Clothes Remover

用于从照片中去除衣服的在线人工智能工具。

Undress AI Tool

Undress AI Tool

免费脱衣服图片

Clothoff.io

Clothoff.io

AI脱衣机

Video Face Swap

Video Face Swap

使用我们完全免费的人工智能换脸工具轻松在任何视频中换脸!

热门文章

<🎜>:泡泡胶模拟器无穷大 - 如何获取和使用皇家钥匙
3 周前 By 尊渡假赌尊渡假赌尊渡假赌
北端:融合系统,解释
4 周前 By 尊渡假赌尊渡假赌尊渡假赌
Mandragora:巫婆树的耳语 - 如何解锁抓钩
3 周前 By 尊渡假赌尊渡假赌尊渡假赌

热工具

记事本++7.3.1

记事本++7.3.1

好用且免费的代码编辑器

SublimeText3汉化版

SublimeText3汉化版

中文版,非常好用

禅工作室 13.0.1

禅工作室 13.0.1

功能强大的PHP集成开发环境

Dreamweaver CS6

Dreamweaver CS6

视觉化网页开发工具

SublimeText3 Mac版

SublimeText3 Mac版

神级代码编辑软件(SublimeText3)

热门话题

Java教程
1669
14
CakePHP 教程
1428
52
Laravel 教程
1329
25
PHP教程
1273
29
C# 教程
1256
24
Python vs. JavaScript:学习曲线和易用性 Python vs. JavaScript:学习曲线和易用性 Apr 16, 2025 am 12:12 AM

Python更适合初学者,学习曲线平缓,语法简洁;JavaScript适合前端开发,学习曲线较陡,语法灵活。1.Python语法直观,适用于数据科学和后端开发。2.JavaScript灵活,广泛用于前端和服务器端编程。

从C/C到JavaScript:所有工作方式 从C/C到JavaScript:所有工作方式 Apr 14, 2025 am 12:05 AM

从C/C 转向JavaScript需要适应动态类型、垃圾回收和异步编程等特点。1)C/C 是静态类型语言,需手动管理内存,而JavaScript是动态类型,垃圾回收自动处理。2)C/C 需编译成机器码,JavaScript则为解释型语言。3)JavaScript引入闭包、原型链和Promise等概念,增强了灵活性和异步编程能力。

JavaScript和Web:核心功能和用例 JavaScript和Web:核心功能和用例 Apr 18, 2025 am 12:19 AM

JavaScript在Web开发中的主要用途包括客户端交互、表单验证和异步通信。1)通过DOM操作实现动态内容更新和用户交互;2)在用户提交数据前进行客户端验证,提高用户体验;3)通过AJAX技术实现与服务器的无刷新通信。

JavaScript在行动中:现实世界中的示例和项目 JavaScript在行动中:现实世界中的示例和项目 Apr 19, 2025 am 12:13 AM

JavaScript在现实世界中的应用包括前端和后端开发。1)通过构建TODO列表应用展示前端应用,涉及DOM操作和事件处理。2)通过Node.js和Express构建RESTfulAPI展示后端应用。

了解JavaScript引擎:实施详细信息 了解JavaScript引擎:实施详细信息 Apr 17, 2025 am 12:05 AM

理解JavaScript引擎内部工作原理对开发者重要,因为它能帮助编写更高效的代码并理解性能瓶颈和优化策略。1)引擎的工作流程包括解析、编译和执行三个阶段;2)执行过程中,引擎会进行动态优化,如内联缓存和隐藏类;3)最佳实践包括避免全局变量、优化循环、使用const和let,以及避免过度使用闭包。

Python vs. JavaScript:社区,图书馆和资源 Python vs. JavaScript:社区,图书馆和资源 Apr 15, 2025 am 12:16 AM

Python和JavaScript在社区、库和资源方面的对比各有优劣。1)Python社区友好,适合初学者,但前端开发资源不如JavaScript丰富。2)Python在数据科学和机器学习库方面强大,JavaScript则在前端开发库和框架上更胜一筹。3)两者的学习资源都丰富,但Python适合从官方文档开始,JavaScript则以MDNWebDocs为佳。选择应基于项目需求和个人兴趣。

Python vs. JavaScript:开发环境和工具 Python vs. JavaScript:开发环境和工具 Apr 26, 2025 am 12:09 AM

Python和JavaScript在开发环境上的选择都很重要。1)Python的开发环境包括PyCharm、JupyterNotebook和Anaconda,适合数据科学和快速原型开发。2)JavaScript的开发环境包括Node.js、VSCode和Webpack,适用于前端和后端开发。根据项目需求选择合适的工具可以提高开发效率和项目成功率。

C/C在JavaScript口译员和编译器中的作用 C/C在JavaScript口译员和编译器中的作用 Apr 20, 2025 am 12:01 AM

C和C 在JavaScript引擎中扮演了至关重要的角色,主要用于实现解释器和JIT编译器。 1)C 用于解析JavaScript源码并生成抽象语法树。 2)C 负责生成和执行字节码。 3)C 实现JIT编译器,在运行时优化和编译热点代码,显着提高JavaScript的执行效率。

See all articles