Java单行多行注释怎么用

Java注释看似简单，实则暗藏诸多易被忽视的语法陷阱：单行注释（//）仅限本行、不可跨行，多行注释（/*...*/）不支持嵌套且极易因遗漏闭合符导致编译器“吞掉”后续大量代码，而文档注释（/**...*/）虽具特殊用途却不能混作普通注释；更需警惕的是，注释并非语法“安全区”——字符串内写//或/*无影响，但字符常量中误写'/*'会直接编译失败，甚至注释与代码交错（如Stri//ng）也会破坏词法结构；真正棘手的问题往往隐身于编辑器高亮失效后的未闭合注释中，只能靠编译错误位置艰难反推。掌握这些细节，才能让注释真正服务开发，而非成为调试路上的隐形地雷。

Java里单行注释用 //，多行注释用 /* ... */，但二者不能嵌套，且多行注释不支持“半行续写”式写法。

单行注释 // 的实际用法

它从 // 开始直到行末都视为注释内容，适合快速说明某一行逻辑或临时屏蔽代码。

• 可以出现在行首、行中甚至行尾：int x = 1; // 初始化x
• 不会影响编译，也不会被JVM加载，纯粹给开发者看
• 不能跨行：换行后必须重新写 //，否则下一行不是注释
• 慎用于调试时“注释掉一段代码”，如果原代码里已有 // 或 /*，可能造成意外语法混乱

多行注释 /* ... */ 的边界行为

它从 /* 开始，到最近的 */ 结束，中间所有内容（含换行、空格、甚至无效语法）都被忽略。

• 可用于注释掉多行代码，比如临时禁用一个方法体：/* public void foo() { ... } */
• 不支持嵌套：写 /* /* inner */ outer */ 会报错，因为第一个 */ 就结束了整个注释
• 不能“悬空”：如果忘记写 */，编译器会一路吞掉后面所有代码，直到文件末尾或遇到下一个 */，错误提示往往在很远之后才出现
• 文档注释 /** ... */ 是特例，会被 javadoc 工具识别，但它不属于普通多行注释范畴

别踩这些坑：注释和代码共存时的常见问题

注释不是“安全区”，它和代码共享同一解析上下文，某些位置放错会直接破坏语法结构。

• 在字符串字面量里写 // 或 /* 不会触发注释——它们就是普通字符：String s = "x // y";
• 但若在字符常量里误写 /*，比如 char c = '/*';，会编译失败，因为字符字面量只允许单个字符
• 注释不能拆开关键字：写 Stri// comment ng 不等于 String，编译器按词法切分，Stri 是非法标识符
• IDE有时会自动补全 */，但手写时容易漏掉，尤其在复制粘贴大段注释后

真正麻烦的不是语法记不住，而是注释消失在编辑器高亮里后，你忘了它还卡在某个 /* 没闭合——这种错误往往要靠编译失败的位置反推，而不是靠眼睛扫出来。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Java单行多行注释怎么用》文章吧，也可关注golang学习网公众号了解相关技术文章。