变量和方法命名的最佳实践

这篇具有很好参考价值的文章主要介绍了变量和方法命名的最佳实践。希望对大家有所帮助。如果存在错误或未考虑完全的地方,请大家不吝赐教,您也可以点击"举报违法"按钮提交疑问。

  1. 在每个代码范围内使用足够短和足够长的名称:例如循环计算器用一个字符就可以了,如i;条件和循环变量用一个单词,方法名1-2个单词,类名2-3个单词,全局变量3-4个单词组成
  2. 为变量指定一些专门名称,不要使用例如 "value", "equals", "data" 这样的变量名
  3. 变量名要使用有意义的名称,通过变量名能大概反映出其具体的用途
  4. 不要在变量名前加前缀,例如 o_, obj_, m_ 之类
  5. 服从公司命名规范,在命名时使用一致的做法,例如:txtUserName, lblUserName, cmbSchoolType, ... 除非是大大降低了可读性
  6. 服从编程语言本身的规范,不要使用不连贯的小写和大写混合名称,例如:userName, UserName, USER_NAME, m_userName, username, ...
    • 对 Java 而言:
      • 类名使用驼峰命名方式,如:VelocityResponseWriter
      • 包名小写:net.oschina.beans.xxx
      • 变量名小写开始的驼峰命名,例如:studentParentName
      • 常量名用全大写:MAX_PARAMETER_COUNT = 100
      • 枚举类名参考普通类名,枚举变量使用全大写
      • 不使用任何带下划线的命名方式(OSCHINA项目大量采用带下划线的变量,哈哈),除非是常量或者是枚举值
  7. 不要在同一个类的不同上下文中重用相同的变量名
  8. 不要在一个方法内用同一个变量做不同的用途
  9. 不要使用非 ASCII 字符的变量,例如中文变量
  10. 不要使用太长的变量名,例如50个字符,这很难阅读,而且可能超出一些编译器的限制
  11. 确定并坚持使用固定的一种自然语言的命名方式,例如不要使用拼音和英文混合的命名方式
  12. 方法名要使用有意义的名称,能通过方法名大概了解该方法的用途,而且方法名要以动词开始,例如createPasswordHash
  13. 方法名要符合公司统一的规范,例如:getTxtUserName(), getLblUserName(), isStudentApproved()
  14. 方法名要遵循编程语言规范
  15. 方法的参数名要使用有意义的名称 
  16. List定义的变量应该 List 作为后缀结尾。

    Map定义的变量应该 Map 作为后缀结尾。

    数组定义的变量应该 s 作为后缀结尾。文章来源地址https://www.toymoban.com/news/detail-668451.html

到了这里,关于变量和方法命名的最佳实践的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处: 如若内容造成侵权/违法违规/事实不符,请点击违法举报进行投诉反馈,一经查实,立即删除!

领支付宝红包 赞助服务器费用

相关文章

  • 我在 vscode 插件里接入了 ChatGPT,解决了代码变量命名的难题

    lowcode 插件 已经迭代了差不多3年。作为我的生产力工具,平常一些不需要动脑的搬砖活基本上都是用 lowcode 去完成,比如管理脚手架,生成 CURD 页面,根据接口文档生成 TS 类型,生成 mock 等等。 借助 lowcode 的区块物料的功能,能快速生成 CURD 页面,但是前一段时间在做一些

    2024年02月08日
    浏览(45)
  • Google代码覆盖率最佳实践

    软件质量保障: 所寫即所思|一个阿里质量人对测试的所感所悟。 谷歌一直倡导的领域之一是使用代码覆盖率数据评估风险并识别测试中的真空。然而,代码覆盖率的价值一直是个争议的话题。每次聊到代码覆盖率时,似乎都会引发无尽的争论。由于大家固守自己阵营,所以

    2024年01月16日
    浏览(54)
  • 精通代码复用:设计原则与最佳实践

    在你开始设计的所有层次上,从单一函数、类,到整个库和框架,都需要从一开始就考虑到代码复用。在接下来的文本中,所有这些不同的层次都被称为组件。以下策略将帮助你合理地组织你的代码。注意,所有这些策略都专注于使你的代码具有通用性。设计可复用代码的第

    2024年02月08日
    浏览(48)
  • 掌握TypeScript:10个最佳实践提高代码质量

    TypeScript 是一种强类型的 JavaScript 超集,提供了很多优秀的工具和语言特性,可以帮助开发者提高代码质量和开发效率。在本文中,我们将介绍 10 个 TypeScript 最佳实践,帮助初级和中级的 Web 前端开发工程师更好地使用 TypeScript 开发高质量的代码。 在 TypeScript 中,严格模式可

    2023年04月11日
    浏览(46)
  • 各类Python项目的项目结构及代码组织最佳实践

    1. 了解Python项目文件组织结构非常重要 为什么要掌握python项目结构? 优秀的程序员都使用规范的项目代码结构,了解这些好的习惯方式,有助于快速读懂代码 如果项目是几个人合作开发,好的代码结构,便于分工,减少混乱,使项目开发过程更顺畅。 采用规范的项目结构,

    2023年04月16日
    浏览(117)
  • Java中的安全密码散列:最佳实践和代码示例

    在数字安全领域,密码哈希是防止未经授权访问的重要防线。然而,哈希算法的前景已经发生了重大变化,一些方法已经过时,一些更新、更安全的技术正在出现。本文深入研究了为什么像SHA-512这样的传统方法不再适用,加盐和减慢散列过程的重要性,并为现代密码散列技术

    2024年03月27日
    浏览(39)
  • 探秘前端单元测试的秘密:让代码快速稳定的最佳实践!

    一说到单元测试,可能对于业务一线同学来说,心理立马就会无形中有一种压迫感,心想 “业务都做不完了,写个球的单元测试,先保证功能完备,赶紧上线才是王道”,这句话的核心是以业务为重,没任何问题,但是,业务在任何时候都是重要的,除了业务,其实还有效率

    2024年02月05日
    浏览(42)
  • 深入浅出:MyBatis的使用方法及最佳实践

    创建⼀个全新的 MyBatis 和 Spring Boot 的项⽬时添加引⽤ 如下: 在application.properties中添加如下内容: 依旧在application.properties中添加如下内容: 按照后端开发思路,进行mybatis查询用户的功能,流程图如下: 创建demo数据库 使用数据库 创建学生表 添加学生信息 Mapper 标签:需要

    2024年02月13日
    浏览(49)
  • 从方法论到最佳实践,深度解析企业云原生 DevSecOps 体系构建

    作者:匡大虎 安全一直是企业上云关注的核心问题。随着云原生对云计算基础设施和企业应用架构的重定义,传统的企业安全防护架构已经不能够满足新时期下的安全防护要求。为此企业安全人员需要针对云原生时代的安全挑战重新进行系统性的威胁分析并构建适合企业自身

    2024年01月25日
    浏览(76)
  • 【程序员英语 代码提交】C++工程师的代码提交艺术:git commit 时 精确表达与最佳实践

    在软件开发的世界里,代码提交(Code Commit)不仅仅是一个简单的行为,它是一种艺术,一种传达你工作的方式。当一个C++工程师提交代码时,他们不只是在保存代码的当前状态,而是在向整个团队传达一个信息:这段代码是什么,为什么要这样做,以及它是如何改变项目的

    2024年02月02日
    浏览(71)

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

博客赞助

微信扫一扫打赏

请作者喝杯咖啡吧~博客赞助

支付宝扫一扫领取红包,优惠每天领

二维码1

领取红包

二维码2

领红包