静态内部类是独立于外部类实例的顶层类，不持外部类this引用，可直接实例化且支持static成员；普通内部类则依赖外部类实例、禁止非final static成员，并易致内存泄漏。
静态内部类（static nested class）不是“只能访问静态成员”的普通内部类，而是独立于外部类实例的顶层类——它不持有隐式 this 引用，编译后生成独立的 Outer$StaticInner.class 文件。
静态内部类和普通内部类的根本区别
普通内部类（非 static）编译时会自动持有一个指向外部类实例的隐式引用（字段名类似 this$0），因此必须依附于外部类实例才能创建；而静态内部类没有这个引用，可直接通过 Outer.StaticInner 实例化，甚至可在外部类尚未初始化时使用。
- 普通内部类不能定义
static成员（除static final常量）；静态内部类可以自由定义static字段、方法、嵌套类 - 普通内部类无法在
static上下文中直接 new（如static方法、静态代码块）；静态内部类可以 - 序列化普通内部类实例时，会一并序列化其捕获的外部类实例——容易引发
NotSerializableException；静态内部类无此风险
什么时候该用静态内部类而不是独立顶层类
当某个类逻辑上紧密属于外部类，但又不需要访问外部类的实例成员时，静态内部类是更优封装选择。它比顶层类更能表达“归属关系”，又比普通内部类更轻量、无内存泄漏隐患。
- 作为工具类的私有实现：比如
HashMap的Node、TreeMap的Entry都是static的 - 构建器模式中的
Builder类：如AlertDialog.Builder，避免暴露给全局命名空间 - 避免因误用普通内部类导致的内存泄漏（Android 中常见）：静态内部类 +
WeakReference是 Handler / AsyncTask 的标准规避方案
如何正确声明和访问静态内部类
声明只需在 class 前加 static；访问时无需外部类实例，但需注意访问权限控制——默认包级可见，若为 private，则仅外部类可构造。
生成Blender Python (bpy)脚本，该脚本使用node_groups API和GeometryNodeTree接口程序化地创建几何节点修改器树，用于参数化3D资产生成。
立即学习“Java免费学习笔记（深入）”；
public class Config {
private static final String VERSION = "1.2.0";
public static class Builder {
private String host;
private int port;
public Builder host(String h) {
this.host = h;
return this;
}
public Config build() {
return new Config(this);
}
}
private Config(Builder b) {
// 可直接访问外部类的 static 成员
System.out.println("Built with version: " + VERSION);
}
}
- 外部类可直接访问静态内部类的
private成员（反之亦然） - 静态内部类不能直接访问外部类的非
static字段或方法（除非传入实例引用） - 若静态内部类定义了与外部类同名的
static字段，需用OuterClass.field显式限定
编译产物与反射注意事项
静态内部类编译后是独立的 class 文件，JVM 不认为它是“内部类”——isMemberClass() 返回 false，getEnclosingClass() 返回 null。但 isStatic() 为 true，且 getName() 包含 $ 符号。
- 用反射获取静态内部类：需用
Class.forName("pkg.Outer$StaticInner")，不能写成Outer.StaticInner.class（编译期语法，运行时无效） - 泛型静态内部类（如
Outer<t>.StaticInner</t>）在字节码中会被擦除，类型参数只存在于源码层面 - 若静态内部类被声明为
private，反射调用getDeclaredConstructor().setAccessible(true)才能实例化
真正容易出错的地方在于混淆“静态内部类”和“匿名静态类”（比如 new SomeInterface() { ... } 写在 static 方法里），后者仍是非静态的——它没有名字，但依然隐式持有外部类实例引用（除非外部类是 static 上下文且无实例可持）。这种细节不看字节码几乎无法察觉。
