单行注释以//开头，用于代码内部简要说明，仅限一行，不被javadoc工具处理；文档注释以/*开头、/结尾，可跨多行，包含@param、@return等标签，用于生成API文档，主要描述公共类、方法和字段，可被javadoc提取为HTML格式的正式说明。
单行注释和文档注释在Java中用途不同，语法也不同，主要区别体现在作用范围、使用场景和是否能被工具处理上。
语法形式不同
单行注释以两个斜杠开头：//，只能注释一行内容，编译器会忽略该行中注释后的所有内容。
文档注释以/**开头，以*/结尾，可以跨多行，专门用于描述类、方法、字段等程序元素。
用途和生成文档能力不同
单行注释主要用于代码内部的简单说明，帮助开发者理解某一行或某一段逻辑，比如：
立即学习“Java免费学习笔记（深入）”；
// 计算用户年龄// 临时调试用，后续需优化
这类注释不会生成外部文档。
高级Bash脚本编程指南 chm版
下载
这本书假定你没有任何关于脚本或一般程序的编程知识, 但是如果你具备相关的知识, 那么你将很容易就能够达到中高级的水平. . . 所有这些只是UNIX®浩瀚知识的一小部分. 你可以把本书作为教材, 自学手册, 或者是关于shell脚本技术的文档. 书中的练习和样例脚本中的注释将会与读者进行更好的互动, 但是最关键的前提是: 想真正学习脚本编程的唯一途径就是亲自动手编写脚本. 这本书也可作为教材来讲解一般的编程概念. 向伟大的中华民族的Linux用户致意! 我希望这本书能够帮助你们学习和理解L
文档注释则用来生成API文档。通过javadoc工具可以提取文档注释内容，生成HTML格式的说明文档。常用于公共类、方法和字段的说明，例如：
/*** 返回用户姓名
* @return 用户的全名字符串
*/
public String getName() { ... }
支持特殊标签
文档注释可以包含@param、@return、@throws等标签，用于描述参数、返回值和异常信息，这些标签对生成结构化文档至关重要。
单行注释不支持这类结构化标签，也不能被javadoc工具识别和提取。
基本上就这些。单行注释是写给开发人员看的临时备注，文档注释是写给使用者看的正式说明。
