以下是 Java 標準注解（內置注解）的詳細說明及使用場景：

---

1. 核心標準注解

(1) @Override

• 用途：標記一個方法覆蓋父類的方法或實現接口的抽象方法。
• 約束：
  • 若方法未正確覆蓋/實現，編譯器會報錯。
  • 不能用于字段或類。
• 示例：

  @Override
  public void toString() {return "Custom toString()";
  }
  

(2) @Deprecated

• 用途：標記過時的類、方法或字段，編譯器會發出警告。
• 約束：
  • 使用時需配合 @deprecated Javadoc 標記說明替代方案。
• 示例：

  @Deprecated
  public void oldMethod() {System.out.println("This method is deprecated!");
  }
  

(3) @SuppressWarnings

• 用途：抑制特定編譯器警告（如未使用的變量）。
• 參數：指定要抑制的警告類型（如 "unchecked"、"rawtypes"）。
• 示例：

  @SuppressWarnings({"unchecked", "rawtypes"})
  public void suppressWarningsExample() {List untypedList = new ArrayList(); // 抑制未指定泛型的警告
  }
  

---

2. 元注解（Meta-Annotations）

元注解用于定義其他注解的特性，是注解的注解：

(1) @Target

• 用途：指定注解可應用的目標元素類型。
• 參數：ElementType 枚舉值（如 METHOD, FIELD, TYPE 等）。
• 示例：

  @Target(ElementType.METHOD)
  @interface MyAnnotation {}
  

(2) @Retention

• 用途：指定注解的保留階段。
• 參數：RetentionPolicy 枚舉值：
  • SOURCE：僅存在于源碼，編譯時丟棄（默認）。
  • CLASS：編譯到 class 文件，但運行時不可訪問。
  • RUNTIME：運行時可通過反射獲取。
• 示例：

  @Retention(RetentionPolicy.RUNTIME)
  @interface RuntimeAnnotation {}
  

(3) @Documented

• 用途：將注解包含在 Javadoc 文檔中。
• 示例：

  @Documented
  @interface DocumentedAnnotation {}
  

(4) @Inherited

• 用途：允許子類繼承父類的注解（僅對類級別注解有效）。
• 示例：

  @Inherited
  @interface InheritedAnnotation {}@InheritedAnnotation
  class Parent {}class Child extends Parent {} // 自動繼承 @InheritedAnnotation
  

---

3. Java 8+ 新增注解

(1) @SafeVarargs

• 用途：抑制使用泛型數組時的 unchecked 警告，需確保參數不“泄漏”。
• 約束：僅對靜態/最終方法有效。
• 示例：

  @SafeVarargs
  public final <T> void safeMethod(List<T>... lists) {// 安全操作泛型數組
  }
  

(2) @FunctionalInterface

• 用途：標記一個接口為函數式接口（僅一個抽象方法）。
• 約束：若接口不符合條件，編譯器報錯。
• 示例：

  @FunctionalInterface
  interface MyFunc {void execute(); // 允許默認/靜態方法
  }
  

---

4. 其他常用注解

(1) @Repeatable（Java 8+）

• 用途：允許在同一位置多次使用同一注解（需配合容器注解）。
• 示例：

  @Repeatable(Roles.class)
  @interface Role {String value();
  }@Role("admin") @Role("user")
  class MyClass {} // 等價于 @Roles({@Role("admin"), @Role("user")})
  

(2) @Native

• 用途：標記本地方法（native 關鍵字的替代，但實際未被廣泛使用）。

---

5. 使用場景總結

注解	典型用途
@Override	確保方法覆蓋正確性。
@Deprecated	標記廢棄的 API，提示開發者使用新方法。
@SuppressWarnings	抑制特定編譯器警告（需謹慎使用，優先修復問題）。
@Target	定義自定義注解的適用范圍。
@Retention	控制注解的生命周期（如是否在運行時可用）。
@FunctionalInterface	確保接口適合作為 Lambda 表達式的目標。

---

6. 注意事項

1. 避免過度使用 @SuppressWarnings
   優先修復警告根源，而非簡單忽略。
2. 自定義注解設計
   通過元注解（@Target、@Retention）明確注解的約束和用途。
3. 運行時處理
   若需反射讀取注解信息，必須設置 @Retention(RUNTIME)。

---

7. 示例：自定義注解

// 自定義注解：標記需要日志記錄的方法
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@interface Loggable {String value() default "INFO";
}// 使用示例
public class MyService {@Loggable("DEBUG")public void doSomething() {// 方法體}
}

---

8. 總結

Java 標準注解提供了編譯時驗證、文檔生成、運行時處理等能力，是代碼規范和工具鏈（如框架、IDE）的重要基礎。合理使用注解可以提升代碼的可維護性和安全性。