美文网首页
简述命名的礼仪

简述命名的礼仪

作者: zqq90 | 来源:发表于2023-04-18 17:24 被阅读0次

命名空间

时刻审视是否恰当的使用了「命名空间」, 保持较低的入侵性,降低冲突的可能性,不要给他人或将来的自己带来不便

避免重复表达

重复表达将使你的表达变得啰嗦, 试着精炼你的语言

反例: Clock.stopClock() 正例 Clock.stop()

尊重特定词汇的原本大小写

Beijing, URL, Java, JDK, GitLab, GitHub, Spring Cloud, jOOQ

以上书写,在注释和文档应保持原样

但在特定场景的命名规范中,也应注意转换:

  • 大驼峰: Beijing, Url, Java, Jdk, Gitlab, Github, SpringCloud, Jooq
  • 首字母大写 + 横线: Spring-Cloud

常见场景举例:

  • 大驼峰: Java、JS、TS、Golang 等类型, Golang 方法等
  • 小驼峰: 局部变量, 方法名等
  • 全小写 + 下划线: 部分 API 字段命名规范
  • 全大写 + 下划线: 枚举值, 常量, Error Code
  • 全小写 + 横线: URL/URI 链接, Spring Boot 配置文件 (application*.yml)
  • 首字母大写 + 横线: HTTP Header
  • 首字母大写 + 空格: 标题, 菜单(项), Label, 特称
  • 首单词首字母大写: 注释, 描述信息

扩展阅读

相关文章

  • NDN命名网络简述

    NDN网络工作机制和优点 工作机制 NDN中的通信是由接收端(即数据消费者)驱动的。为了接收数据,一个消费者发出一...

  • 请简述.NET的命名空间

    命名空间 一个程序集内相关类型的一个分组,一个程序集可以包含任意个命名空间,每个命名空间又可以包含多种类型。 根命...

  • 『Python基础练习题』day01

    1.简述变量命名规范 2.name = input(“>>>”) name变量是什么数据类型? 3.if条件语句的...

  • 116.Hive查询NULL异常分析与解决

    116.1 问题简述 Hive创建的Parquet格式的表,重命名表的列名后,查询重名的列数据时显示当前列所有值为...

  • RecyclerView-为Adapter增加粘性头部支持(第5

    效果图 简述 这一篇我们继续扩展上一篇的SwipeAdapter,增加粘性头部的支持,我们命名为PinnedAda...

  • 小成图

    录自《斐然数术集》第八章,p329~p341。 周易小成图简述 ... 一、“小成图”的命名 《周易》文辞古奥,不...

  • 良好的算法编写习惯

    简述, 如果是做算法题, 应该注意如下: 用全名去命名变量, 不会英语就用拼音 先理解题意, 想好了再开始动手 编...

  • BEM命名法

    简述 试想在一个html页面中引入各种外部css样式文件,如果外部的样式的命名不能确定,那么就不能保证该html页...

  • 浅谈OC类别(Category)

    简述 类别是一种为现有类添加新方法的方式,我们有时可以见到“类名称+类别名称”的命名方式。类别可以添加属性prop...

  • (原创 )公职人员应注意的8种形象与礼仪,实用干货,大家都看看吧

    (作者:beina) 本篇主讲公务员的基本礼仪,涵盖常用礼仪、服饰礼仪、目光礼仪、电话礼仪、接待礼仪、介绍礼仪、鼓...

网友评论

      本文标题:简述命名的礼仪

      本文链接:https://www.haomeiwen.com/subject/bctbsltx.html