@Native是Java中用于标记public static final字段的元注解，提示头文件生成工具该字段值由native侧提供，Java层仅作符号声明，编译期生成#define而非硬编码值。
@Native 是 Java 中一个用于标记字段的元注解，它的作用是向 JNI（Java Native Interface）头文件生成工具（如 javah 或现代的 javac -h）表明：该字段是一个由本地代码（C/C++）定义并使用的常量，Java 层仅作声明，**实际值由 native 侧提供**。它本身不生成任何运行时行为，纯粹是编译期提示。
什么时候需要 @Native
当你在 Java 类中声明一个 public static final 字段（如 int、long、String 等），但这个值并非在 Java 中初始化，而是由 C/C++ 动态提供（例如通过 JNI 在 JVM 启动时注入），或者你希望生成的 JNI 头文件中**不包含该字段的硬编码值**（避免 Java 和 native 侧值不一致），就应该用 @Native 标记。
典型场景包括：
- 与系统库约定的错误码、标志位（如
ERROR_INVALID_HANDLE）、协议常量； - Java 层仅作为符号占位，真实值由 native 库在运行时决定；
- 需要头文件中只声明符号名，不展开为字面量（比如防止 C 预处理器误替换或类型截断）。
如何正确使用 @Native
只需将 @Native 加在字段声明前，且字段必须满足：public static final，类型为基本类型或 String（JDK 8+ 支持 String，但注意早期版本仅支持数值型）。
立即学习“Java免费学习笔记（深入）”；
示例：
public class NativeConstants {
@Native public static final int STATUS_OK = 0;
@Native public static final int STATUS_ERROR = -1;
@Native public static final String VERSION = "1.2.3"; // JDK 8+
}
编译后执行：javac -h ./jni NativeConstants.java
生成的 NativeConstants.h 中，对应字段会以 #define 形式声明（而非赋值），例如：
#define STATUS_OK 0 #define STATUS_ERROR -1 #define VERSION "1.2.3"
注意：如果字段没有 @Native，javac -h 默认仍会生成 #define；但加上它，语义更明确，且某些构建工具或检查器会依赖该标记做校验。
常见误区与注意事项
-
@Native不影响 Java 运行时——字段仍可被 Java 代码读取，只要它有初始值（即使标记了@Native，Java 编译器仍要求final字段必须显式初始化）； - 它不是让 JVM 去“找 native 实现”，而是告诉头文件生成器：“别把这值当 Java 常量硬编码进头文件，留给 native 侧统一管理”；
- 不能用于方法、类或参数；只能用于字段；
- 从 JDK 17 开始，
javah已彻底移除，统一用javac -h，而@Native在该命令下依然有效； - 若字段值在 Java 中初始化（如
public static final int X = 42;），又加了@Native，头文件仍会生成#define X 42—— 它不禁止生成值，只是表明“此值应与 native 侧保持一致”。真正起作用的是开发约定和构建流程控制。
替代方案与现代实践
纯 Java 常量 + @Native 适合轻量集成。但更健壮的做法是：
- 将常量完全移出 Java，只在 C 头文件中定义，Java 层通过 JNI 函数获取（如
getErrorCodeName()）； - 使用资源文件或配置加载常量，避免编译期耦合；
- 在构建脚本（如 CMake + Gradle）中统一管理常量源，自动生成 Java 和 C 的声明。
总之，@Native 是一个轻量但重要的契约标记，用在需要 Java 与 native 共享符号定义、且强调“值由 native 主导”的场景。不复杂，但容易忽略其设计意图。
