局部内部类必须定义在方法或代码块内，不能出现在类成员位置；只能用abstract或final修饰，不可用访问控制符或static；可访问外部类所有成员及方法中final或“事实上final”的变量。
局部内部类必须定义在方法或代码块内
Java 中的局部内部类（Local Inner Class）不能出现在类的成员位置，只能写在方法、构造器或初始化块里。它和局部变量一样，作用域受限，出了所在代码块就不可见。
常见错误是把它误当成普通内部类，比如写在类体中但没加 static 修饰——这会直接编译失败，报错：Illegal modifier for the local class; only abstract or final is permitted。
- 必须用
abstract或final修饰（Java 8+ 允许省略，但底层仍视为final） - 不能有访问控制符（
public/private/protected不合法） - 不能使用
static，否则变成静态嵌套类，不再是局部类 - 可以访问所在方法的
final或“事实上 final”的局部变量（Java 8+ 放宽限制）
局部内部类访问外部变量的限制
它能直接访问外部类的成员（包括私有字段和方法），也能访问所在方法的参数和局部变量——但后者必须是 final 或等效 final（即定义后未被重新赋值）。这个限制源于生命周期不一致：方法栈帧弹出后，局部变量消失，而局部类实例可能还活着。
例如下面这段代码在 Java 7 会编译失败，Java 8+ 可通过：
立即学习“Java免费学习笔记（深入）”；
void outerMethod() {
int x = 10;
class Local {
void print() { System.out.println(x); } // OK in Java 8+
}
x = 20; // ❌ 若取消注释，x 就不是“事实上 final”，编译报错
}
- 如果变量被修改过（哪怕只改一次），就不能在局部类中引用
- 外部类字段无此限制，哪怕是
private也能直接读写 - 若需修改外部局部状态，可改用数组或包装类（如
AtomicInteger）
局部内部类与匿名类的取舍
当只需要创建一次、且逻辑简单时，优先用匿名类；需要复用、定义多个方法或构造器时，才选局部内部类。
比如实现一个带状态的比较器，或者封装一段需要多次调用的回调逻辑：
public ListfilterByLength(List list, int minLen) { class LengthFilter { boolean matches(String s) { return s != null && s.length() >= minLen; } String pad(String s) { return "[" + s + "]"; } } LengthFilter filter = new LengthFilter(); return list.stream() .filter(filter::matches) .map(filter::pad) .collect(Collectors.toList()); }
- 匿名类无法定义构造器或多个方法，扩展性差
- 局部类可定义多个方法、字段、构造器，结构更清晰
- 二者都会隐式持有外部类引用，注意内存泄漏风险（尤其在长生命周期对象中使用）
编译后生成的字节码文件名规律
局部内部类不会生成独立的源文件，但编译后会出现形如 OuterClass$1Local.class 的文件（数字递增，按出现顺序编号）。这个命名规则容易让人误以为它是匿名类——其实只要类名非空（即不是 new X(){...} 形式），就是局部类。
调试时要注意：IDE 可能不显示这类类的源码跳转，反编译工具看到的类名也带数字前缀，容易和匿名类混淆。
- 用
javap -c OuterClass.class可确认是否存在该类及其方法签名 - 若局部类引用了非 final 局部变量，编译器会自动生成合成字段并传入构造器，这点可通过字节码验证
- 避免在 lambda 表达式中再嵌套局部类——语法合法但可读性极差，几乎没人这么干
局部内部类的真实复杂度不在语法，而在生命周期管理和变量捕获的隐式行为。稍不注意，就会在异步回调或缓存场景中触发意料外的引用滞留。
