<p>Java注释不会被编译进class文件；//和/ /在编译时被javac完全丢弃，仅Javadoc注释（/* /）供javadoc工具提取生成API文档，而注解是否进入字节码取决于@Retention策略。</p>
Java注释会被编译进class文件吗
不会。普通单行//和块注释/* */在编译阶段就被javac完全丢弃，字节码里找不到任何痕迹。
只有@Deprecated这类标记型注解（不是注释）会保留到字节码——但这是注解（@interface定义的），和人写的说明性注释是两回事。
@Documented注解和javadoc的关系
@Documented只影响javadoc工具能否把该注解本身生成进API文档，和源码里的/** */注释是否被提取无关。
javadoc能提取的是符合Javadoc语法的/** */注释（含@param、@return等标签），它不读取@Documented，也不依赖运行时注解保留策略。
立即学习“Java免费学习笔记（深入）”；
常见错误现象：
– 写了@Documented但没写/** */，结果javadoc里啥也没有
– 在//里写了详细说明，以为javadoc能扫到，实际完全忽略
Runtime注解保留策略对字节码的影响
注解是否进入字节码，取决于它的@Retention策略：
-
@Retention(RetentionPolicy.SOURCE)：仅保留在源码，编译后消失（如@Override） -
@Retention(RetentionPolicy.CLASS)：保留在class文件，但JVM加载时不进内存（默认值） -
@Retention(RetentionPolicy.RUNTIME)：进class文件，且可被反射读取
注意：RetentionPolicy.CLASS和RUNTIME都会让注解数据写入字节码的RuntimeVisibleAnnotations属性，只是后者多了JVM支持反射访问。
性能影响很小，但RUNTIME注解会增加class体积，并可能被反射意外调用——不用反射就别设成RUNTIME。
想让说明文字进字节码？只能靠常量或字符串
如果真需要“注释内容”出现在运行时（比如调试信息、配置描述），唯一可靠方式是显式转成字符串常量：
public static final String SERVICE_DESC = "处理订单超时重试，幂等由上游保证";
或者用private static final字段+构造器初始化。不要指望任何注释语法能绕过javac的剥离逻辑。
容易被忽略的一点：IDE和构建工具（如Gradle的javadocJar）可能缓存旧的javadoc输出，改了/** */注释后没重新运行javadoc任务，就会看到“注释没更新”的假象。
