---
title: "native 环境准备"
---

环境要求： `graalvm 17+` + `native-image`



### 1、软件要求

| 用途 | 要求 | 说明 |
| --- | --- | --- |
| 普通开发 | JDK 8+ | `-P aot` 任意 JDK 可用 |
| Native 构建 | GraalVM JDK 17+（含 native-image） | 推荐 graalvm 17 / 21 / 25 |
| 操作系统 | 原生工具链 | macOS：Xcode Command Line Tools；<br/>Linux：gcc、glibc-devel、zlib-devel；<br/>Windows：Visual Studio Build Tools |
| 构建机内存 | ≥ 8G 可用内存 | native-image 构建较耗内存 |

### 2、graalvm 17（或 graalvm 21，或 graalvm 25 等）

学习文档：https://www.graalvm.org/latest/getting-started/

下载地址：https://github.com/graalvm/graalvm-ce-builds/releases



下载对应 JDK 版本的 GraalVM（如 `graalvm-community-jdk-17_...`），解压后配置：

```shell
# mac/linux 示例：设置环境变量（按实际路径调整）
export JAVA_HOME=/path/to/graalvm-community-jdk-17
export PATH=$JAVA_HOME/bin:$PATH
export GRAALVM_HOME=$JAVA_HOME
```

验证：

```shell
java -version
# 应显示 GraalVM 相关版本信息
```

### 3、native-image

安装文档：https://www.graalvm.org/latest/reference-manual/native-image/#install-native-image

```
gu install native-image
```


验证：

```
native-image --version
```

### 4、IDEA 配置（推荐）

* 项目 SDK 切换为 graalvm（File → Project Structure → SDKs，添加刚解压的 graalvm 目录）
* Maven Runner 的 JRE 同步切换
* 多模块项目注意：所有模块统一使用 graalvm SDK

### 5、macOS 特别提醒

若 `native-image` 构建时报找不到链接器，需先安装 Xcode 命令行工具：

```
xcode-select --install
```