0

0

Java中的单行注释和多行注释

yulia

yulia

发布时间:2018-09-15 17:57:06

|

8857人浏览过

|

来源于php中文网

原创

在编程中,注释是必不可少的一部分,注释一方面可以看清代码的结构,找起来更方便,另一方面,也有利于同事之间的工作交接。那么今天就和大家聊聊java中的单行注释和多行注释吧,有需要的朋友可以参考一下,希望对你有所帮助。

什么是注释?注释就是一段文字,这段文字并不是必须的,也不直接参与代码运行。

注释用来说明某段代码的作用,或者说明某个类的用途,每个方法的功能,以及该方法的参数和返回值的数据类型及意义等。

为什么要添加注释?

1,永远不要过于相信自己的理解力。为了过段时间还能简单明了的看懂自己的以前的代码,建议添加注释。
2,可读性第一,效率第二。团队协同开发中,团队成员的沟通比较重要,为了自己写的代码能被整个团队理解,建议添加注释。
3,代码即文档。自己平时写一些代码,为了生成一些规范的文档,建议添加注释。

立即学习Java免费学习笔记(深入)”;

实际工作中,经常会听到一些同事说别人的代码没注释怎么怎么样,实际上写的漂亮的代码不需要太多的注释,相反的,我个人对于满屏幕的注释或者是一些无用的代码极其反感,特别是使用git,svn等工具做版本管理之后,我都会把那些无用的注释掉的代码全部删掉。

这里整理一下我对注释的个人理解:

1,必要的注释还是必须要有的,比如说Javabean中的字段意义,就应该有相关的注释。比如说一些编码中暂时实现功能,但是存在一些不好的待优化的地方,我一般会写一个TODO,实现基本功能后续我自己再回过头来完善。
2,不要写一些白痴的无用注释,不要保留任何一行被注释掉的代码,现在代码一般都有版本工具做管理,所以根本不用担心代码会丢掉。
3,严格的遵守Java的命名规范,不用担心变量名称太长,不用担心方法名称太长,合理的一个英语的翻译命名比写那些无用的汉语注释强多啦。

程序注释是源代码的一个重要部分,对于一份规范的程序源代码来说,注释应该占到源代码的三分之一左右。

几乎所有的编程语言都提供了注释的功能,一般的编程语言都提供了基本的单行注释和多行注释,Java也不例外。除此之外,Java语言还提供了一种文档注释。

灵云AI开放平台
灵云AI开放平台

灵云AI开放平台

下载

这篇博客先整理一下Java中的单行注释和多行注释,文档注释一般用来生成API。

单行注释和多行注释

单行注释就是在程序中注释一行代码,在Java语言中,将双斜线"//"放在需要注释的内容之前就可以啦。

在eclipse中,单行注释的快捷键是command+/,按一次是添加注释,在按一次就是取消注释。

多行注释就是一次性的将程序中的多行代码注释掉,在Java语言中,使用"/*"和"*/"将程序中需要注释的内容包含起来,"/*"表示注释开始,"*/"表示注释结束。

在eclipse中,多行注释的快捷键是command+control+/,使用的时候要选中代码,我一般很少用多行注释。

现在贴出一段代码,来演示一下Java中的单行注释和多行注释。

/**
 * Java的单行注释和多行注释.
 * 
 * @author LinkinPark
 */
public class Comment
{
 public static void main(String[] args)
 {
  // 这里是Java的单行注释
  System.out.println("演示Java的单行注释。。。");
  /*
   * 这里是Java的多行注释
   */
  System.out.println("演示Java的多行注释。。。");
 }
}

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
eclipse教程
eclipse教程

php中文网为大家带来eclipse教程合集,eclipse是一个开放源代码的、基于Java的可扩展开发平台。就其本身而言,它只是一个框架和一组服务,用于通过插件组件构建开发环境。php中文网还为大家带来eclipse的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

197

2023.06.14

eclipse怎么设置中文
eclipse怎么设置中文

eclipse设置中文的方法:除了设置界面为中文外,你还可以为Eclipse添加中文插件,以便更好地支持中文编程。例如,你可以安装EBNF插件来支持中文变量名,或安装Chinese Helper来提供中文帮助文档。本专题为大家提供eclipse设置中文相关的各种文章、以及下载和课程。

807

2023.07.24

c语言编程软件有哪些
c语言编程软件有哪些

c语言编程软件有GCC、Clang、Microsoft Visual Studio、Eclipse、NetBeans、Dev-C++、Code::Blocks、KDevelop、Sublime Text和Atom。更多关于c语言编程软件的问题详情请看本专题的文章。php中文网欢迎大家前来学习。

625

2023.11.02

Eclipse版本号有哪些区别
Eclipse版本号有哪些区别

区别:1、Eclipse 3.x系列:Eclipse的早期版本,包括3.0、3.1、3.2等;2、Eclipse 4.x系列:Eclipse的最新版本,包括4.0、4.1、4.2等;3、Eclipse IDE for Java Developers等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

181

2024.02.23

eclipse和idea有什么区别
eclipse和idea有什么区别

eclipse和idea的区别:1、平台支持;2、内存占用;3、插件系统;4、智能代码提示;5、界面设计;6、调试功能;7、学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

153

2024.02.23

eclipse设置中文全教程
eclipse设置中文全教程

本专题整合了eclipse设置中文相关教程,阅读专题下面的文章了解更多详细操作。

117

2025.10.10

eclipse字体放大教程
eclipse字体放大教程

本专题整合了eclipse字体放大教程,阅读专题下面的文章了解更多详细内容。

158

2025.10.10

eclipse左边栏不见了解决方法
eclipse左边栏不见了解决方法

本专题整合了eclipse左边栏相关教程,阅读专题下面的文章了解更多详细内容。

120

2025.10.15

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

69

2026.03.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kotlin 教程
Kotlin 教程

共23课时 | 4.4万人学习

C# 教程
C# 教程

共94课时 | 11.4万人学习

Java 教程
Java 教程

共578课时 | 82.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号