Java内部类是编译器生成独立类文件的真实类，能访问外围类私有成员但隐式持有外围类引用；匿名内部类要求局部变量final或“事实final”以解决生命周期不匹配问题。
Java里的内部类不是语法糖，是编译器在字节码层面生成独立类文件的真类——它能访问外围类的私有成员，但代价是隐式持有一个外围类实例引用。
为什么匿名内部类访问局部变量必须加 final 或“事实 final”
因为局部变量生命周期在方法栈帧里，而内部类对象可能存活更久。JVM 通过把变量值“拷贝”进内部类的字段来解决生命周期不匹配问题，所以必须确保这个值不会变。
- Java 8+ 允许“事实 final”：变量没显式声明
final，但没被重新赋值，编译器自动处理 - 如果变量后续被修改，编译直接报错：
local variables referenced from an inner class must be final or effectively final - 注意：
final修饰的是变量引用本身，不是它指向的对象内容（比如final List<string> list = new ArrayList();</string>，仍可调用list.add()）
static 内部类和普通内部类的关键区别
根本差异在于是否持有外围类实例引用——这直接影响内存泄漏风险和使用场景。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 普通内部类（非
static）：编译后生成Outer$Inner.class，构造时自动注入外围类引用（this$0字段），因此不能定义静态成员（除静态常量） -
static内部类：不持外围类引用，可独立于外围类实例存在，可定义任意静态成员，推荐用于工具类、Builder 模式等 - 误用非
static内部类作为线程任务或回调，容易导致外围 Activity/Fragment 无法回收（Android 场景典型泄漏源）
什么时候该用局部内部类而不是 lambda
lambda 只能实现函数式接口（单抽象方法），而局部内部类可以实现多个接口、继承类、定义构造器、有自己字段——当需要这些能力时，lambda 就不够用了。
立即学习“Java免费学习笔记（深入）”；
- 需要重写多个方法（如同时实现
Runnable和自定义监听接口） - 需要保存状态：局部内部类可定义实例字段，lambda 只能捕获“事实 final”的局部变量
- 需要显式构造逻辑：比如传参初始化、做校验，lambda 无构造器
- 调试时更清晰：局部内部类有类名，堆栈信息比 lambda 的
Outer$$Lambda$1/0x0000000800c12345可读得多
内部类最易被忽略的点是引用传递的隐式性——哪怕你只写 new Inner()，编译器也在背后塞了一个 this，这个细节在序列化、跨模块传递、反射调用时常常突然暴露问题。
