@deprecated 注解可用于标记 java 成员变量表示弃用，仅提示不阻止编译运行；建议配合 javadoc 说明弃用原因及替代方案，并逐步迁移、最终删除字段。
在 Java 中，@Deprecated 注解可以用于标记成员变量（即字段），表示该变量已不推荐使用，应被替代或移除。
直接标注成员变量
只需在字段声明前加上 @Deprecated 即可。编译器会发出警告，IDE 通常也会显示删除线样式：
- @Deprecated private String oldConfig;
- @Deprecated public static final int MAX_RETRY = 3;
注意：仅加注解不会阻止代码编译或运行，只是提示开发者谨慎使用。
配合 Javadoc 说明弃用原因和替代方案
强烈建议同时写 Javadoc，说明为什么弃用、何时弃用、以及该用什么代替。这样能提升可维护性：
Java JDK 25
下载
Java JDK 25 来自 OpenJDK 官方归档，版本为 JDK 25，本条下载地址已指向官方 Windows x64 zip 安装包直链，适合调试旧项目或兼容旧版 Java 运行环境。
/**
* @deprecated 使用 {@link #newConfig} 替代，旧配置格式已停用
*/
@Deprecated
private String oldConfig;
IDE 和文档生成工具（如 Javadoc）会把 @deprecated 标签内容一并展示，比单纯加注解更有效。
注意作用域和继承行为
@Deprecated 标注的字段在子类中继承时，其弃用状态也一并继承：
- 子类访问父类的
@Deprecated字段，同样会触发编译警告 - 若子类重写（遮蔽）该字段（如重新声明同名字段），新字段需单独标注
- 不能通过
@SuppressWarnings("deprecation")在字段声明处压制警告，只能在使用处压制
不推荐只标注不清理
标注后应逐步迁移调用方代码。长期保留大量 @Deprecated 字段会降低代码清晰度：
- 可在后续版本中将字段设为
private并移除外部访问 - 最终在大版本升级时彻底删除字段，并同步更新所有引用
- 避免对已弃用字段再添加新逻辑或修复 bug
不复杂但容易忽略。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
