开发者社区

文档建议反馈控制台

最新优惠活动

文章/答案/技术大牛

发布

@命名注释异常

命名注释异常是指在代码中使用注释来解释变量、函数、类等的命名时出现的异常情况。通常情况下，注释应该用于解释代码的逻辑和功能，而不是用于解释命名本身。因此，当注释被用于解释命名时，就会出现命名注释异常。

命名注释异常的出现可能是由于以下几种情况：

命名不清晰：当命名本身不够清晰明了时，开发人员可能会使用注释来解释命名的含义。这可能是因为命名过于简单、不具备描述性，或者命名与实际功能不符。这种情况下，应该考虑修改命名，使其更加清晰易懂，而不是依赖注释来解释。
命名冲突：有时候，在代码中可能会出现多个相似的命名，容易引起混淆。为了区分它们，开发人员可能会使用注释来解释每个命名的具体含义。然而，这种情况下应该优先考虑修改命名，使其具备唯一性和描述性，以避免混淆。
命名错误：有时候，在代码中可能会出现命名错误，即命名与实际功能不符。为了弥补这个错误，开发人员可能会使用注释来解释命名的实际含义。然而，这种情况下应该优先考虑修复命名错误，使其与实际功能相符，而不是依赖注释来解释错误的命名。

总之，命名注释异常是一种不推荐的编程实践，应该尽量避免。合理的命名和清晰的代码结构是更好的选择，可以提高代码的可读性和可维护性。

腾讯云相关产品和产品介绍链接地址：

腾讯云开发者平台：https://cloud.tencent.com/developer
腾讯云云服务器（CVM）：https://cloud.tencent.com/product/cvm
腾讯云对象存储（COS）：https://cloud.tencent.com/product/cos
腾讯云人工智能（AI）：https://cloud.tencent.com/product/ai
腾讯云物联网（IoT）：https://cloud.tencent.com/product/iot
腾讯云区块链（BCS）：https://cloud.tencent.com/product/bcs
腾讯云视频处理（VOD）：https://cloud.tencent.com/product/vod
腾讯云数据库（TencentDB）：https://cloud.tencent.com/product/cdb

相关搜索:@Throw注释有多个异常 Discord.Py:无法重命名通道，没有任何异常 Django异常未注册的命名空间 ESLint:如何对VSCode folding regions注释进行间隔注释异常 Spring GetMapping注释异常 TemplateDoesNotExist异常- Django未从命名空间模板加载模板 throw/catch异常命名的起源是什么？以编程方式添加Spring异常处理程序，而不使用@ExceptionHandler注释(或任何其他注释)？使用@Bean Spring注释创建Bean时出现异常使用JUnit 4注释测试多个异常

相关搜索:

页面内容是否对你有帮助？

有帮助

没帮助

相关·内容

java web注释_webservice命名空间

://blog.csdn.net/gjb724332682/article/details/46317345 parameterStyle：确定方法参数是否表示整个消息正文，或者参数是否是包装在以操作命名的顶层元素中的元素

2.1K1 0

python变量和常量命名、注释规范

参考链接： Python变量，常量和文字学习python编程前先学习一下变量和常量命名规范以及注释规范，要从一开始就养成良好习惯，避免将来遇到一些不必要的麻烦。...注释可以放心大胆的用中文。取名时要遵循一些原则，通常变量、常量是指某一事物或事物的某一属性，所以变量名、常量名通常使用英文的一个或多个名词命名。... __xx__ ，这样的变量都是系统保留命名规则，程序员写的变量避免用这样的格式。 ...注释单行注释可以单独写一行，也可写在代码行的末尾。单行注释以#开头跟2各空格再跟#再跟一个空格，然后写注释，例如： _salary = 6666 # 私有属性薪水，不能公开访问。 ...多行注释最常用的场合是给类、函数注释说明文档，例如： def add_x_y(x, y): # 下面的多行注释，'''开头位置一定要注意缩进，'''结束位置单独占一行可以不讲究缩进。

1.9K2 0

Dart主函数、注释、变量、常量、命名规则

注释 Dart的注释分为单行注释、多行注释、文档注释。注意，在Dart中，对于连续多行的文档注释，建议用 /// 来注释，而不是 /* */来注释。 ? 3....5.命名规则 1. 变量名称必须由数字、字母、下划线和美元符($)组成； 2. 标识符开头不能是数字； 3. 标识符不能是保留字和关键字； 4. 变量的名字是区分大小写； 5.

9241 0

PHP系列 | PHP Document 注释标记及规范 && PHP命名规范

@var 指明变量类型 @version 指明版本信息 @todo 指明应该改进或没有实现的地方 @throws 指明此函数可能抛出的错误异常,极其发生的情况普通的文档标记标记必须在每行的开头以@标记...，除此之外，还有一种标记叫做inline tag,用{@}表示，具体包括以下几种： {@link} 用法同@link {@source} 显示一段函数或方法的内容注释规范 a.注释必须是 /** *...注释内容 */ 的形式 b.对于引用了全局变量的函数，必须使用glboal标记。...百度百科 1.类名：大驼峰命名法 2.类属性： public、protected类型的，小驼峰命名法； private类型的，下划线（_）开头，小驼峰命名法； 3.类方法： public、protected...类型的，小驼峰命名法； private类型的，下划线（_）开头，小驼峰命名法； 4.类方法参数：小驼峰命名法； 5.函数：采用C GNU的惯例，所有的字母使用小写字母，使用下划线（_）分割单词； 6.函数参数

1.2K2 1

Lua⭐️print方法与注释、Lua中标识符命名规则等

print方法与注释 print("Hello World") print("Skode") print("Hello World"); print("Skode"); --两个单横杠为单行注释，...print用以向控制台输出字符 --[[ 两个单横杠+两个括号为多行注释 --]] ---[[ 三个斜杠取消注释，下方的括号也被两个杠单行注释掉了现在这行可运行 --]] print：输出 lua...语言，末尾可加分号，也可不加 Lua中标识符命名规则等简单资料查询菜鸟教程补充信息在以后博客中记录大家还有什么问题，欢迎在下方留言！

151 0

3.29 PHP基础知识标记的5种写法、注释、命名规则等

每行php代码末尾都要加 ; （分号）; Ctrl+d 复制当前行 echo 输出字符串换行分割线 PHP注释代码： 1.单行注释：双斜杠//后面跟注释内容; //单行注释;...2.多行注释：注释内容用/* */包括; /* * 多行注释 * function name * Author Deshun * date 2017/3/19 */ 3.shell风格的注释...：#号后面跟注释内容; #shell风格的注释; php变量的命名规则： $开头，后接字母或是下划线;（注意：不能以数字开头） $name = "Liu"; //定义一个字符串变量 echo $name...= "jack"; //采用英文或者英文加数字，方便查看 $lastName = "joe"; 用中文命名变量：可以用中文命名变量 $名字 = "mary"; //中文定义变量 echo $名字; /.../输出这个变量声明：本文由w3h5原创，转载请注明出处：《3.29 PHP基础知识标记的5种写法、注释、命名规则等》 https://www.w3h5.com/post/5.html

1K0 0

JavaScript企业级编程规范(1)-文件命名-注释规范-id与class

04 CSS,LESS,SCSS文件命名参照项目命名规则,当遇到多个单词组成时，采用中划线连接方式，比如说：retina-sprites.scss 05 HTML文件命名同样参照项目命名,都小写的方式...有了它,真的可以减少不少变量命名的痛苦. 07 注释规范涉及到文档注释,单行注释与多行注释,变量语句,函数注释文档注释当针对整个文件的注释，必须放在js⽂文件的开头，注释顺序及内容如下，这个不是硬性规定的...变量语句注释针对变量中的语句注释,可以放在变量定义行和语句行的上一行,使用javaScript标准的单行注释,如下所示 // 获取窗口的宽度 var nWidth = widow.screen.width...> id 和 class的命名总规则为：内容优先,表现为辅., 首先根据内容来命名, 比如 main-nav....,less,sass,html,图片资源,注释规范,id与class命名以上列出的规范并不是硬性的,遵从自己项目的规范就好,写出让人看得懂的代码个人觉得最佳学习方式,就是参考学习厉害的人的代码

9952 0

如何编写高质量的 JS 函数（2） -- 命名注释鲁棒篇

（一）函数命名一、目前前端的函数命名存在什么问题从上图可以知道，命名和缓存是计算机科学中的两大难题。本文要说的函数命名，虽然涉及到的范围较窄，但思想都一样，完全可以借鉴到其他的形式中。...之前阅读过代码大全中变量的相关章节，也针对性的了解过一些源码，根据我的经验总结，目前函数命名除了业界标准的问题外，还存在一些细节的问题，比如：中英语言的差异性不懂得从多维度去提升命名的准确性（如何从多维度去提升命名的准确性...三、如何让命名有英语 style 举个例子： componentDidMount 是 react 等生命周期的钩子，但是为什么要这样命名？...函数注释如下图： ? 由此知道，如果函数命名存在困难，可以通过注释的方式，将函数的整体介绍和说明输出文档来解决这个问题。...，通过语法的学习和借助工具，函数命名基本可以解决，如果遇到无法清晰描述所写函数的目的的命名时，请务必给函数写上良好注释，不管函数名字有多长多难懂，只要有良好的注释，那就是可以接受的一件事情。

1.4K2 0

JavaScript注释（多行注释+单行注释）

JavaScript注释（多行注释+单行注释）注释就是不被解析的一串字符。JavaScript 注释有以下两种方法：单行注释：//单行注释信息。多行注释：/*多行注释信息*/。...示例1 把位于//字符后一行内的所有字符视为单行注释信息。下面几条注释语句可以位于代码段的不同位置，分别描述不同区域代码的功能。...//程序描述 function toStr(a){ //块描述 //代码段描述 return a.toString(); //语句描述 } 使用单行注释时，在//后面的同一行内的任何字符或代码都会被忽视...示例2 使用/*和*/可以定义多行注释信息。...，包含在/*和*/符号之间的任何字符都视被为注释文本而忽略掉。

2272 0

Flutter自动注释(尾注释)、 Android Studio自动注释(尾注释)

4.勾选show closing labels in Dart source code，然后点击ok，就可以美滋滋写Flutter了

3.3K1 0

【Python】Python 注释 ( 单行注释 | 多行注释 | 代码示例 )

文章目录一、Python 注释 1、单行注释 2、多行注释 3、代码示例单行注释 : # 单行注释多行注释 : """ 多行注释多行注释多行注释 """ 一、Python 注释 ---- Python...注释可以对代码进行解释说明 , 代码中的注释不会被执行 , 可以增加代码的可读性 ; 1、单行注释单行注释 : Python 中的单行注释以 # 开头 , # 右边是注释内容 ;...单行注释中 , # 与注释内容建议使用空格隔开 , 这是 Python 官方的建议 , 建议大家都遵守该规范 ; 单行注释可以独立占一行 , 也可以写在代码右侧 ; 在 C / C++ /...之间添加空格 , 警告信息消失 ; 代码示例 : 下面的代码中 , 第一行中的单行注释独占一行 , 第二行中的单行注释在代码的右侧 ; # 单行注释 print(123) #...单行注释 2、多行注释 Python 多行注释使用三个双引号引起来 ; 三个双引号即可以进行单行注释 , 又可以多行注释 , 代码如下 : """ 多行注释 """ """ 多行注释

4.6K4 0

vim批量注释删除注释

vim批量注释/删除注释注释： control + v 进入 V-BLOCK模式（可视化块模式）使用上下（k、j）移动选定要注释的行【左右（h、l）则是选择列】 shift + i （大写...i）进入插入模式输入注释符 // 或 # 连续按两次ESC，完成删除注释： control + v 进入 V-BLOCK模式（可视化块模式）使用上下（k、j）移动选定要注释的行...，如果注释为 //，则使用左右（h、l）选择两列 d，删除注释

2.3K2 0

mysql添加表注释、字段注释、查看与修改注释

1 创建表的时候写注释 create table test1 ( field_name int comment ‘字段的注释’ )comment=’表的注释’; 2 修改表的注释 alter...table test1 comment ‘修改后的表的注释’; 3 修改字段的注释 alter table test1 modify column field_name int comment ‘...修改后的字段注释’; –注意：字段名和字段类型照写就行 4 查看表注释的方法 –在生成的SQL语句中看 show create table test1; –在元数据的表里面看 use information_schema...; select * from TABLES where TABLE_SCHEMA=’my_db’ and TABLE_NAME=’test1′ \G 5 查看字段注释的方法 –show show

7.2K4 0

PhpStorm 头部注释、类注释和函数注释的设置

*设置位置：”Settings”->”file templates”; 如下图，设置头部注释、类注释以及函数注释，时间、用户名、文件名称等随机改变的属性，直接使用其下方已经定义的属性即可。...*生成注释,输入”/**“,按”enter“键即可出现对应注释内容。

2.6K3 0

腾讯云-Istio案例分析: 端口命名不满足约束导致流量异常

但 istio 和 k8s 的适配并非完全没有冲突, 一个典型问题就是 istio 需要 k8s service 按照协议进行端口命名(port naming)。...端口命名不满足约束而导致的流量异常，是使用 mesh 过程中最常见的问题，其现象是协议相关的流控规则不生效，这通常可以通过检查该 port LDS 中 filter 的类型来定位。...如果开启嗅探：数据流最开始会被认定为 L7 http 协议，但是后续数据不符合 http 格式，流量将被中断建议生产环境不使用协议嗅探, 接入 mesh 的 service 应该按照约定使用协议前缀进行命名

2.7K1 0

Shell单行注释与多行注释

1.单行注释众所周知，Shell中使用 # 进行单行注释。...#-------------------------------------------- # 这是一个注释 # author：dablelv # company：tencent #----------...---------------------------------- 2.多行注释在开发过程中，遇到大段的代码需要注释时，使用 # 注释每一行显得效率低下，可以使用如下方式，进行多行注释。...#或者 :<<0 语句1 语句2 0 （2）方法二 if false;then 语句1 语句2 fi （3）方法三只需要将第一个条件置为false，那么后面的大括号的内容将不会被执行，达到了多行注释的效果...3.小结 Shell多行注释方法多样，本文仅列出部分可用方法，仅供参考。其它可用方法，不再一一推导列举，大家可举一反三。

6.6K2 0

注释

一、⽬标注释的作⽤注释的分类及语法注释的特点二、注释的作用没有注释的代码添加注释的代码通过⽤⾃⼰熟悉的语...三、注释的分类及语法注释分为两类：单⾏注释和多⾏注释。...单行注释只能注释一行内容，语法如下： # 注释内容多⾏注释可以注释多行内容，一般用在注释⼀段代码的情况，语法如下： """ 第⼀⾏注释第⼆⾏注释第三...⾏注释 """ ''' 注释1 注释2 注释3 ''' 快捷键：ctrl + / 3.1 快速体验 # 输出hello world print('hello world') print(...注释的分类单行：# 注释内容，快捷键ctrl+/ 多行：""" 注释内容 """ 或 ''' 注释内容 ''' 解释器不执行注释内容

1466 0

vim指定行注释和解注释

1.vim底行命令模式 1.64至74行首插入"#": 64, 74 s/^/#/g 64 #[Running] python -u "\Py\deco_1...

2.4K2 0

Mysql 查看表注释或字段注释

查看所有表的注释 SELECT table_name 表名, table_comment 表说明 FROM information_schema.TABLES WHERE table_schema =...'数据库名' ORDER BY table_name 查询所有表及字段的注释 SELECT a.table_name 表名, a.table_comment 表说明, b.COLUMN_NAME 字段名...COLUMNS b ON a.table_name = b.TABLE_NAME WHERE a.table_schema = '数据库名' ORDER BY a.table_name 查询某表的所有字段的注释...'主键', NAME VARCHAR(300) comment '姓名', CREATE_TIME date comment '创建时间' )comment = '用户信息表'; 修改表/字段的注释...修改表注释 alter table t_user comment = '修改后的表注释信息(用户信息表)'; 修改字段注释 alter table t_user modify column id int

10.4K1 1

Java魔法堂：注释和注释模板

一、注释　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　 1. 注释类型 [a]....单行注释 // 单行注释 String type = "单行注释"; [b]. 多行注释 /* * 多行注释 */ String type = "多行注释"; [c]....文档注释 /** * 文档注释 */ public class Dummy{} 2. 快捷键 [a]. 添加/取消单行注释： Ctrl+/ [b]....添加类的文档注释： Ctrl+Shift+j 二、注释模板　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　作用：定义文件、类和方法等默认的注释格式，减少手工输入的工作量。...导入、导出注释模板在 Window->Preference->Java->Code Style->Code Template 下可导入导出注释模板。

2.6K6 0

点击加载更多

扫码

添加站长进交流群

领取专属 10元无门槛券

手把手带您无忧上云

扫码加入开发者社群

相关资讯

热门标签

活动推荐

运营活动

活动名称

广告关闭