Solon v4.0.5

native 环境准备

</> markdown
2026年8月12日 上午11:13:56

环境要求： 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；
Linux：gcc、glibc-devel、zlib-devel；
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_...），解压后配置：

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

验证：

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