必须使用 OuterClass.this 的情况有三：一是内部类与外部类同名字段冲突时访问外部类字段；二是内部类重写外部类方法后需调用原始版本；三是需将外部类实例传递给其他方法。

在 Java 中，内部类（非静态嵌套类）默认持有对外部类实例的隐式引用。当内部类中存在与外部类同名的成员（比如变量或方法），或者需要明确调用外部类的某个成员时，就可以使用 OuterClass.this 来显式访问外部类的当前实例及其成员。

什么时候必须用 OuterClass.this？

当内部类定义了与外部类同名的字段或方法时，直接使用变量名会优先访问内部类自己的成员。此时若想访问外部类的同名成员，就必须通过 OuterClass.this.fieldName 或 OuterClass.this.methodName() 显式指定。

• 内部类和外部类有同名字段（如都叫 name）
• 内部类重写了外部类的方法，但仍需在内部类中调用外部类原始版本
• 需要将外部类实例传递给其他方法（例如作为回调参数）

基本语法和写法

OuterClass.this 是一个指向 enclosing instance（外围实例）的引用，类型就是 OuterClass。它只能在非静态内部类中使用，不能在静态嵌套类（static nested class）中使用，因为后者不持有外部类实例引用。

写法示例：

class Outer {
    String name = "Outer";

    class Inner {
        String name = "Inner";

        void printNames() {
            System.out.println("Inner.name: " + name);           // 输出 "Inner"
            System.out.println("Outer.name: " + Outer.this.name); // 输出 "Outer"
        }
    }
}

调用外部类方法和构造器

除了访问字段，OuterClass.this 还可用于调用外部类的实例方法，甚至在内部类构造器中用于传递外部类引用。

• 调用外部类方法：Outer.this.doSomething()
• 在内部类构造器中保存外部类引用：this.outerRef = Outer.this;
• 作为参数传给其他对象：someService.register(Outer.this);

常见误区提醒

注意几个容易出错的地方：

• 静态内部类不能用 OuterClass.this，因为它没有外部类实例绑定
• this 在内部类中默认指代内部类自身，不是外部类
• 如果外部类字段是 private，Outer.this.field 依然可访问（内部类天然可访问外部类所有成员）
• 匿名内部类、局部内部类同样支持 OuterClass.this 语法