在macos上安装graalvm jdk 21需下载对应芯片架构的tar.gz包,解压后用sudo移至/library/java/javavirtualmachines/,再配置graalvm_home指向/contents/home并更新path;验证时java -version、javac -version应显示graalvm ce字样,gu list须确认native-image已安装。

在macOS上安装GraalVM JDK 21并正确配置环境变量,是运行原生镜像编译、多语言互操作及高性能Java应用的前提,跳过任一环节都可能导致native-image命令不可用或java -version仍指向系统默认JDK。
下载并解压GraalVM JDK 21
访问GraalVM CE官方GitHub Releases页面:https://github.com/graalvm/graalvm-ce-builds/releases,找到最新版graalvm-jdk-21的macOS压缩包——M系列芯片选_macos-aarch64_bin.tar.gz,Intel芯片选_macos-x64_bin.tar.gz。
下载完成后,在终端执行解压命令,例如:tar -xzf graalvm-jdk-21.0.3+11.1_macos-aarch64_bin.tar.gz。
将解压出的文件夹移入系统Java虚拟机目录:sudo mv graalvm-jdk-21.0.3+11.1 /Library/Java/JavaVirtualMachines/。这一步需要输入管理员密码,【必须使用sudo,否则后续JAVA_HOME无法被系统级进程识别】。
配置GRAALVM_HOME与PATH环境变量
打开你的shell配置文件。如使用zsh(macOS Catalina及以后默认),编辑~/.zshrc;如用bash,则编辑~/.bash_profile。
在文件末尾添加两行:
export GRAALVM_HOME=/Library/Java/JavaVirtualMachines/graalvm-jdk-21.0.3+11.1/Contents/Home
export PATH=$GRAALVM_HOME/bin:$PATH
保存后执行source ~/.zshrc(或对应配置文件)使变量立即生效。注意:不要漏掉/Contents/Home这一层路径,【路径错误会导致javac、native-image等命令全部报“command not found”】。
验证安装结果
在新打开的终端窗口中,依次执行以下三条命令:
java -version
javac -version
gu list
前两条应显示类似openjdk version "21.0.3" 2024-04-16且包含GraalVM CE字样;第三条应列出native-image已安装(状态为installed)。若gu list报错或未显示native-image,请立即执行gu install native-image。











