【Java】深入理解 native 方法：从概念到 C 语言实现

By - YunYang
Posted on 2026-04-062026-04-06
Posted in Java

【Java】深入理解 native 方法：从概念到 C 语言实现

大家好，我是云扬～今天和大家聊聊 Java 中的 native 方法，这个看似神秘的关键字背后，藏着 Java 与其他语言交互的核心逻辑。作为后端开发者，掌握 native 方法和 JNI 技术，能让我们在性能优化、功能扩展等场景中多一种解决方案。

一、native 方法是什么？

native 方法 是用native关键字修饰的 Java 方法，它最特别的地方在于：不需要用 Java 语言实现方法体。简单说，这就是 Java 留给其他语言（C/C++/ 汇编等）的 “接口”，允许我们在 Java 代码中调用非 Java 编写的功能。

// 典型的native方法声明
public class HelloJNI {
    // native关键字修饰，无方法体，仅声明
    public native void sayHello();
    
    // 加载动态链接库（后续会讲）
    static {
        System.loadLibrary("hello");
    }
    
    public static void main(String[] args) {
        new HelloJNI().sayHello(); // 调用本地方法
    }
}

这里要注意：native关键字必须放在返回类型之前，不能和abstract共存（抽象方法是需要 Java 实现的，而 native 方法由外部实现），且没有大括号包裹的方法体。

二、JNI：连接 Java 与其他语言的桥梁

要让 Java 调用本地方法，离不开 JNI（Java Native Interface） —— 这是 Java 平台内置的交互机制，从 Java 1.1 就已存在。

什么时候需要用 JNI？

标准 Java 类库满足不了需求（比如操作特定硬件、调用系统底层 API）；
已有成熟的 C/C++ 类库，不想用 Java 重复开发；
对性能要求极高的核心方法（比如高频计算），用 C/C++/ 汇编优化。

JNI 的优缺点很鲜明

✅ 优点：扩展 Java 能力，关键场景提升性能；

❌ 缺点：丧失跨平台性（需为不同系统编译本地库），本地代码 bug 可能导致 JVM 崩溃。

三、实战：用 C 语言实现 Java native 方法

下面通过一个完整的 HelloWorld 案例，带大家走通 native 方法的开发流程。

步骤 1：编写 Java 类（声明 native 方法）

创建HelloJNI.java文件，代码如下：

public class HelloJNI {
    // 声明native方法，无实现
    public native void sayHello();
    
    // 静态代码块：加载动态链接库
    static {
        // "hello"是库名，后续生成的库文件需匹配（如libhello.so、hello.dll）
        System.loadLibrary("hello");
    }
    
    public static void main(String[] args) {
        // 调用本地方法
        new HelloJNI().sayHello();
    }
}

步骤 2：编译 Java 类生成.class 文件

在命令行执行编译命令：

javac HelloJNI.java

执行后会生成HelloJNI.class文件。

步骤 3：生成 JNI 头文件（.h）

Java 9 及以上版本用javac -h命令（Java 8 及以下用javah -jni）：

# 生成头文件到当前目录（. 表示当前路径）
javac -h . HelloJNI.java

执行后会生成HelloJNI.h头文件，内容如下（关键部分已标注）：

/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class HelloJNI */

#ifndef _Included_HelloJNI
#define _Included_HelloJNI
#ifdef __cplusplus
extern "C" {
#endif
/*
 * Class:     HelloJNI
 * Method:    sayHello
 * Signature: ()V
 */
// JNI方法名格式：Java_类名_方法名
JNIEXPORT void JNICALL Java_HelloJNI_sayHello
  (JNIEnv *, jobject);

#ifdef __cplusplus
}
#endif
#endif

步骤 4：用 C 语言实现 native 方法

创建HelloJNI.c文件，实现头文件中声明的方法：

// 引入JNI头文件和标准输入输出头文件
#include "HelloJNI.h"
#include <stdio.h>

// 实现JNI方法，方法名必须和头文件一致
JNIEXPORT void JNICALL Java_HelloJNI_sayHello
  (JNIEnv *env, jobject obj) {
    // 本地代码逻辑：打印一句话
    printf("Hello, JNI! This is a native method implemented in C language~\n");
}

JNIEnv *env：JNI 环境指针，提供调用 Java 代码的接口；
jobject obj：对应 Java 中的HelloJNI实例（类似 this）。

步骤 5：生成动态链接库

根据操作系统不同，编译命令有所区别：

Linux/Mac：生成.so或.dylib文件

# Linux：gcc编译生成libhello.so
gcc -fPIC -I$JAVA_HOME/include -I$JAVA_HOME/include/linux -shared -o libhello.so HelloJNI.c

# Mac：clang编译生成libhello.dylib
clang -fPIC -I$JAVA_HOME/include -I$JAVA_HOME/include/darwin -shared -o libhello.dylib HelloJNI.c

Windows：用 MinGW 生成.dll文件

gcc -I"%JAVA_HOME%\include" -I"%JAVA_HOME%\include\win32" -shared -o hello.dll HelloJNI.c

注意：$JAVA_HOME需替换为你的 JDK 安装路径（如/Library/Java/JavaVirtualMachines/jdk1.8.0_301.jdk/Contents/Home）。

步骤 6：运行 Java 程序

确保动态链接库和HelloJNI.class在同一目录，执行：

java HelloJNI

成功输出：

Hello, JNI! This is a native method implemented in C language~

四、JNI 调用流程梳理

Java代码（HelloJNI.main()）→ 调用native方法（sayHello()）→ JNI接口（Java_HelloJNI_sayHello）→ 本地C代码（printf输出）→ 结果返回Java

五、实战注意事项

本地方法尽量集中在少数类中，降低 Java 与 C/C++ 的耦合；
动态链接库的命名必须规范（Linux/Mac 前缀为lib，后缀为.so/.dylib；Windows 后缀为.dll）；
调用System.loadLibrary()时，只需要传入库名（如hello），不需要加前缀和后缀；
跨平台部署时，需为每个目标系统重新编译本地代码。

总结

native 方法和 JNI 为 Java 提供了与其他语言交互的能力，是性能优化和功能扩展的重要手段。但它也带来了跨平台性丧失、安全性降低等问题，因此非必要场景不建议滥用。初学者只需理解其核心概念和调用流程，在实际工作中遇到具体需求时，再深入研究细节即可～

如果大家在实践过程中遇到问题，欢迎在评论区交流讨论！

Tags:Java

云扬のBlog