Java中只有//、/.../、/.../三种合法注释；单行注释//从符号至行末忽略，不跨行且不识别字符串内//；多行注释/.../不支持嵌套；Javadoc注释/.../需严格格式，影响文档生成但不进入class文件。

Java 中只有三种合法的注释形式，其余所谓“注释”要么是语法错误，要么是被编译器忽略的无效写法。

单行注释用 //，从符号开始到行末全部忽略

这是最常用也最安全的注释方式，适合临时禁用代码、添加简短说明或调试标记：

• // 后面必须紧跟一个空格（非强制但属通用规范），例如 // 初始化连接池

  

  而不是 //初始化连接池
• 不能跨行，遇到换行即终止；若在字符串内出现 //，不会被识别为注释（因为已处于字面量中）
• 常见误用：把 // 写成 /// 或 ////——多出来的斜杠只是普通字符，无特殊含义

多行注释用 /* ... */，支持嵌套吗？不支持

该形式可用于跨行说明或临时屏蔽大段代码，但有明确限制：

• 不支持嵌套：写 /* outer /* inner */ outer end */ 会导致编译失败，JDK 会报错 unclosed comment
• 可出现在代码任意位置（包括语句中间），例如 int x = 10 /* + 20 */; 是合法的，但可读性极差，不建议
• 注意与文档注释混淆：虽然都用 /* 开头，但只有以 /** 开始的才是 Javadoc 注释

Javadoc 注释用 /** ... */，只对 public 成员有效？不一定

该注释会被 javadoc 工具提取生成 API 文档，但其生效范围比很多人想的更灵活：

• 默认情况下，javadoc 只处理 public 和 protected 类型的类、方法、字段；但可通过 -package 或 -private 参数扩展可见性
• 必须严格以 /** 开头、*/ 结尾，且中间每行首的 * 是约定俗成的排版习惯（非语法要求），但 IDE 通常依赖它做格式化
• 常见坑：/* *（星号前有空格）或 /***（三个星号）都不是合法 Javadoc，工具会直接跳过
• 支持标准标签如 @param、@return、@throws，但自定义标签需额外配置才能被识别

真正容易被忽略的是注释与编译过程的关系：所有注释在编译期被完全剥离，不会进入 .class 文件，也不会影响运行时性能。但 Javadoc 注释如果写得不规范，会导致生成文档缺失关键信息，而这种问题往往上线后才暴露——那时连源码都未必还在手边。

# java  # 工具  # 字符串  # int  # class  # public  # private  # protected  # ide  # 不支持  # 文档  # 跨行  # 三种  # 的是  # 这是  # 连接池  # 还在  # 才是  # 约定俗成 

相关栏目： 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571 】

相关推荐： 网站广告牌制作方法,街上的广告牌，横幅，用PS还是其他软件做的？  如何在阿里云香港服务器快速搭建网站？  SQL查询语句优化的实用方法总结  Laravel如何实现多表关联模型定义_Laravel多对多关系及中间表数据存取【方法】  如何挑选优质建站一级代理提升网站排名？  JavaScript常见的五种数组去重的方式  Laravel如何集成第三方登录_Laravel Socialite实现微信QQ微博登录  制作企业网站建设方案,怎样建设一个公司网站？  网站建设要注意的标准 促进网站用户好感度！  浏览器如何快速切换搜索引擎_在地址栏使用不同搜索引擎【搜索】  Win11关机界面怎么改_Win11自定义关机画面设置【工具】  极客网站有哪些,DoNews、36氪、爱范儿、虎嗅、雷锋网、极客公园这些互联网媒体网站有什么差异？  Win11摄像头无法使用怎么办_Win11相机隐私权限开启教程【详解】  Laravel PHP版本要求一览_Laravel各版本环境要求对照  移动端手机网站制作软件,掌上时代，移动端网站的谷歌SEO该如何做？  在线教育网站制作平台,山西立德教育官网？  如何快速启动建站代理加盟业务？  Laravel如何实现事件和监听器？（Event & Listener实战）  进行网站优化必须要坚持的四大原则  详解一款开源免费的.NET文档操作组件DocX（.NET组件介绍之一）  音响网站制作视频教程,隆霸音响官方网站？  UC浏览器如何切换小说阅读源_UC浏览器阅读源切换【方法】  MySQL查询结果复制到新表的方法(更新、插入)  如何用5美元大硬盘VPS安全高效搭建个人网站？  php后缀怎么变mp4格式错误_修改扩展名提示格式不对怎么办【技巧】  Laravel项目结构怎么组织_大型Laravel应用的最佳目录结构实践  如何制作新型网站程序文件,新型止水鱼鳞网要拆除吗？  Edge浏览器怎么启用睡眠标签页_节省电脑内存占用优化技巧  怎么制作网站设计模板图片,有电商商品详情页面的免费模板素材网站推荐吗？  js实现点击每个li节点，都弹出其文本值及修改  JavaScript中如何操作剪贴板_ClipboardAPI怎么用  JS实现鼠标移上去显示图片或微信二维码  Python文件操作最佳实践_稳定性说明【指导】  香港服务器租用每月最低只需15元？  Windows10如何删除恢复分区_Win10 Diskpart命令强制删除分区  ,交易猫的商品怎么发布到网站上去？  java中使用zxing批量生成二维码立牌  大连企业网站制作公司,大连2025企业社保缴费网上缴费流程？  如何在服务器上三步完成建站并提升流量？  Laravel怎么调用外部API_Laravel Http Client客户端使用  七夕网站制作视频,七夕大促活动怎么报名？  Swift中switch语句区间和元组模式匹配  香港服务器网站推广：SEO优化与外贸独立站搭建策略  Laravel如何创建和注册中间件_Laravel中间件编写与应用流程  如何挑选高效建站主机与优质域名？  Laravel如何记录自定义日志？（Log频道配置）  香港服务器网站测试全流程：性能评估、SEO加载与移动适配优化  Laravel如何使用Socialite实现第三方登录？（微信/GitHub示例）  Laravel Eloquent性能优化技巧_Laravel N+1查询问题解决  厦门模型网站设计制作公司,厦门航空飞机模型掉色怎么办？