@FunctionalInterface用于显式标记接口有且仅有一个抽象方法，使编译器检查、防止误加方法并提升可读性；它不改变行为但能提前发现设计错误，是Lambda和方法引用的基石。
Java 中用 @FunctionalInterface 声明函数式接口，主要是为了**显式标记该接口有且仅有一个抽象方法**，让编译器帮你检查、防止误加方法，同时增强代码可读性。它本身不改变接口行为，但能提前发现设计错误。
为什么需要 @FunctionalInterface
函数式接口是 Lambda 表达式和方法引用的基石（如 Runnable、Comparator、Function）。虽然只要接口只有一个抽象方法，编译器就允许用 Lambda，但不加注解容易出错：
- 别人可能无意中添加第二个抽象方法，导致所有使用该接口的 Lambda 报错，却难以定位原因
- 缺少语义提示，阅读代码时无法一眼识别“这是专门用于函数式编程的接口”
- IDE 和编译器无法主动提醒你违反了函数式契约
正确声明方式
在接口定义前加上 @FunctionalInterface，并确保接口里只有一个非默认、非静态的抽象方法：
@FunctionalInterface
public interface Calculator {
int compute(int a, int b); // ✅ 唯一抽象方法
<pre class="brush:php;toolbar:false;">default int add(int a, int b) { return a + b; } // ✅ 默认方法，允许
static void log(String msg) { System.out.println(msg); } // ✅ 静态方法，允许}
如果多写一个抽象方法，编译直接报错：
@FunctionalInterface
public interface BadExample {
void doFirst();
void doSecond(); // ❌ 编译错误：Unexpected @FunctionalInterface annotation
}常见误区提醒
- 不是必须加：只要满足“单抽象方法”，不加也能用 Lambda；但加了更安全、更专业
-
Object 的 public 方法不算数：比如重写
toString()、equals()、hashCode()不影响函数式接口判定 -
继承已有函数式接口要小心：若子接口继承自
@FunctionalInterface接口，自己就不能再声明新抽象方法，否则会破坏契约
配合 Lambda 和方法引用使用
声明后，就能自然地用 Lambda 或方法引用来实例化：
Calculator calc = (x, y) -> x * y; int result = calc.compute(4, 5); // 输出 20 <p>Calculator plus = Integer::sum; System.out.println(plus.compute(3, 7)); // 输出 10</p>
IDE 通常也会在接口上显示 λ 图标，进一步强化其函数式语义。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
