`

3、注释

阅读更多

一、注释

 

  1. 程序中的注释是程序设计者与程序阅读者之间通信的重要手段。 
  2. 被注释的文字,不会被jvm解释执行,用于解释代码的功能
  3. 好的注释规范可以改善软件的可读性,可以让开发人员尽快而彻底地理解新的代码
  4. 好的注释规范可以最大限度的提高团队开发的合作效率。
  5. 长期的规范性编码还可以让开发人员养成良好的编码习惯,甚至锻炼出更加严谨的思维能力。
  6. 在流行的敏捷开发思想中已经提出了将注释转为代码的概念。

二、分类(主要有3种)

 

  1. 单行注释://
  2. 多行注释:/* ...... */ 
  3. 文档注释:/**……*/

文档注释,是java特有的注释,其中注释内容可以被jdk提供的工具javadoc所解释,生成一套以网页文件形式体现的该程序的说明文档

 

三、注意

 

  1. 注释是一个程序员必须要具有的良好编程习惯 
  2. 初学者编写程序可以养成习惯:先写注释再写代码 
  3. 将自己的思想通过注释先整理出来,再用代码去体现 
  4. 因为代码仅仅是思想的一种体现形式而已
分享到:
评论

相关推荐

    CSS3注释叠加效果.zip

    在这个名为"CSS3注释叠加效果.zip"的压缩包中,可能包含了实现这一效果的相关代码示例。 CSS3注释叠加效果可以分为几个关键部分来理解: 1. **选择器与伪类**:CSS3引入了更多的选择器和伪类,例如`:hover`、`:...

    sourceinsight 多行注释 批量注释 反注释

    3. **反注释** 反注释就是移除已经存在的注释,恢复代码的可执行状态。同样,Source Insight提供了便捷的操作方式: - 如果是多行注释,可以使用快捷键`Ctrl+Shift+X`来移除`/*`和`*/`之间的内容。 - 对于行首的...

    ORB_SLAM3源码(附带详细注释)

    本资源包含ORB_SLAM3的源代码,并且附带了详细的注释,这对于理解其工作原理和进行二次开发非常有帮助。 SLAM问题的核心在于如何在一个未知环境中,通过传感器数据来同时估计机器人位置和环境的三维结构。ORB_SLAM3...

    mp3tagv238setup mp3注释修改器

    可以批量修改mp3的注释以及封面图片 不过不是最新版

    sqlite3.c 去注释版 (sqlite 3.6.6.2)

    这个压缩包中的“sqlite3.c 去注释版 (sqlite 3.6.6.2)”是SQLite3源代码的一个版本,特别处理过以便在Visual C++ 6或Visual Studio 2005环境下进行跟踪调试。通常,原始的SQLite3源代码包含了大量的注释,这些注释...

    详解Python3注释知识点

    ### Python3注释知识点详解 #### 一、引言 Python作为一门易读性强且功能丰富的编程语言,在软件开发领域有着广泛的应用。其中,注释是编写清晰代码的重要组成部分之一,它不仅能够帮助开发者理解代码的功能与逻辑...

    毕业设计-基于python的基因组注释管理系统(源码+答辩ppt+开题报告)

    它可以利用用户上传的基因组序列和gff3注释文件自动化生成CDS序列、蛋白质序列以及功能注释信息等,并支持Blast序列相似性搜索、基因ID和注释功能关键词搜索。经过测试,该系统性能稳定,能满足用户的基本需求。

    java的注释规范(单行注释、多行注释、分块注释)

    3. 在必要的地方注释,注释量要适中。注释的内容要清楚、明了,含义准确,防止注释二义性。保持注释与其描述的代码相邻,即注释的就近原则。 4. 对代码的注释应放在其上方相邻位置,不可放在下面。对数据结构的注释...

    PFC3D参考程序流代码注释_PFC_pfc3d_

    3. **时间步进和求解器**:在PFC3D中,时间步进通常是通过欧拉或半隐式方法进行的。注释将解释如何更新颗粒的位置和速度,以及如何迭代以达到稳定状态。 4. **边界条件**:代码会涵盖如何定义和实施各种边界条件,...

    基因组注释管理系统(Python+Django+MySQL).zip

    它可以利用用户上传的基因组序列和gff3注释文件自动化生成CDS序列、蛋白质序列以及功能注释信息等,并支持Blast序列相似性搜索、基因ID和注释功能关键词搜索。经过测试,该系统性能稳定,能满足用户的基本需求。

    ns-3实例代码注释大全

    "ns-3实例代码注释大全" ns-3是一个开源的网络模拟器,能够模拟各种网络场景和协议。本文档提供了ns-3.2.6版本中的默认文档/examples/tutorial/目录下的五篇文档注释,非常详细,基本达到逐字逐句的注释,非常适合...

    金蝶K3数据库表结构及注释

    金蝶K3数据库表结构及注释

    Python中注释(多行注释和单行注释)的用法实例

    而到了Python 3.x,这个问题已经被解决,但出于规范编码和提高代码执行效率的考虑,编写Python程序时,仍然推荐在文件开头添加中文编码声明注释。其语法格式为“#coding=编码”,其中“编码”指程序使用的字符编码,...

    Java注释规范

    3. 在必要的地方注释,注释量要适中,避免过多或过少的注释。 4. 注释的内容要清楚、明了,含义准确,防止注释二义性。 5. 保持注释与其描述的代码相邻,即注释的就近原则。 6. 对代码的注释应放在其上方相邻位置,...

    Eclipse 代码注释模板

    3. **字段注释**:对类中的成员变量进行注释,说明其作用和初始化值。 4. **构造函数注释**:与方法注释类似,但针对类的构造函数。 5. **Javadoc注释**:遵循Javadoc规范的注释,用于生成API文档。Javadoc注释以`...

    代码注释对齐Visual Studio AddIn

    3. **对齐策略**:对于不同类型的注释,AddIn可能有不同的对齐策略。例如,可能会将多行注释的起始符号(*)对齐,或者将单行注释的开头空格数量标准化。 4. **实时更新**:当用户保存文件或在编辑过程中触发自动保存...

    自主研发的批量保留路径清理代码注释工具

    聪哥创作的一款批量保留路径清理代码注释的工具,目前兼容大...3.增加ruby语言的多行注释清理的能力 2022年11月25日更新日志: 1.修复了行内//注释无法清除的bug 2.增加了默认文件类型内容。 3.提升软件的清理性能。

    sourceinsight 代码行注释,去注释代码插件

    3. **使用宏**:在源代码中选中要注释或去注释的行,按下快捷键,即可完成操作。 通过这样的插件,程序员可以大大提高工作效率,尤其是在处理大量代码注释时。同时,自定义宏也体现了Source Insight的灵活性,允许...

    Eclipse Java 注释模板

    3. **增强可读性**:良好的注释有助于理解代码功能,尤其对于复杂项目而言,注释是必不可少的文档。 4. **便于维护**:当需要更新版本信息或者修改作者信息时,只需要更改模板,所有使用该模板的注释都会自动更新。 ...

Global site tag (gtag.js) - Google Analytics