1. 项目缘起为什么M1芯片的Mac装Java 8这么“麻烦”如果你刚拿到一台搭载Apple SiliconM1/M2/M3芯片的Mac兴冲冲地想配置一个Java 8的开发环境大概率会在第一步就卡住。你会发现无论是去Oracle官网还是用Homebrew都很难直接找到一个“原生”的、能在ARM架构上直接运行的JDK 1.8。这和你之前在Intel Mac或者Windows上的经验完全不同不是下载、安装、配置环境变量三步走就能搞定的事。这个“麻烦”的根源在于苹果的芯片架构革命。简单来说M系列芯片是基于ARM架构的而过去几十年包括Intel和AMD的x86芯片都是基于CISC复杂指令集架构。这两种架构的底层指令集完全不同就像两个人说的语言完全不一样。传统的Java 8Oracle JDK 8 / OpenJDK 8是为x86架构编译的它无法直接在ARM架构的M1芯片上“听懂”并执行。因此我们需要寻找特殊的解决方案。这不仅仅是Java 8的问题而是所有历史遗留的、尚未提供ARM原生版本的软件在M1 Mac上都会遇到的挑战。理解了这一点我们就能明白接下来的所有步骤——无论是寻找特殊构建的JDK还是处理IDE的兼容性——本质上都是在解决这个“架构鸿沟”问题。对于开发者尤其是需要维护历史项目很多老项目都强依赖Java 8的特定行为的开发者来说在M1 Mac上搭建一个稳定可用的Java 8环境是一项必须掌握的生存技能。2. 核心方案选型为M1 Mac寻找合适的Java 8既然官方的Oracle JDK 8没有ARM原生版本我们就得转向社区和第三方提供的解决方案。这里有几个主流选择各有优劣我会详细拆解并告诉你我最终的选择和理由。2.1 方案一Azul Zulu Builds of OpenJDK 8这是目前最主流、最被推荐的选择。Azul Systems公司提供了完整的、为Apple Siliconaarch64架构原生构建的OpenJDK 8版本。为什么选择它原生ARM支持这是最关键的一点。Zulu JDK 8 for ARM是真正为M1芯片编译的无需任何转译层性能最好兼容性也最有保障。免费且开源基于OpenJDK完全免费用于开发和部署。长期支持Azul作为专业的JDK发行商会为其构建的版本提供背部的错误修复和安全更新对于需要长期维护Java 8环境的项目来说更安心。下载方便提供.dmg安装包和.tar.gz压缩包两种形式对新手和老手都友好。潜在顾虑有些非常老旧的、依赖特定Oracle JDK实现细节非标准API的应用在Zulu上可能有极低概率出现行为差异但99.9%的企业级应用无此问题。2.2 方案二使用Apple Rosetta 2运行x86版本Rosetta 2是苹果内置的动态二进制转译器它能让为Intel Macx86_64架构编译的软件在M1 Mac上运行。操作方式你可以直接去Oracle官网下载macOS x64版本的JDK 8安装包安装后在终端里通过arch -x86_64 /bin/bash命令启动一个x86模式的Shell然后在这个Shell里配置和使用Java。或者更简单一点直接运行安装好的JDK系统会自动通过Rosetta 2转译。为什么不推荐作为主要方案性能损耗虽然Rosetta 2效率很高但转译过程必然带来性能开销尤其是对于CPU密集型的编译、构建任务。潜在兼容性问题转译并非完美极少数涉及底层系统调用的操作可能会有问题。环境割裂你需要时刻记住某个终端窗口是ARM原生模式还是x86转译模式环境变量和安装的软件会不一致容易混淆。适用场景仅作为临时测试或运行某个必须用特定x86 JDK 8才能启动的遗留工具。2.3 方案三通过Docker运行JDK 8在Docker容器中运行一个Linux版本的JDK 8镜像。由于Docker Desktop for Mac已经完美支持ARM64架构你可以直接拉取ARM版的Linux JDK 8镜像如arm64v8/eclipse-temurin:8-jdk。优点环境完全隔离不影响宿主机可以轻松管理多个不同版本的JDK。缺点不适合作为本地主要开发环境。你需要将代码挂载到容器内进行编译运行或者配置复杂的远程开发对于日常编码、调试来说路径和体验不够直接。结论对于绝大多数希望在M1 Mac上进行本地Java 8开发的用户Azul Zulu Builds of OpenJDK 8是首选方案。它提供了最接近“原生”的体验。本文后续所有步骤也将基于此方案展开。3. 实战步骤下载与安装Azul Zulu JDK 8现在我们开始动手。整个过程分为下载、安装、验证三步。3.1 下载正确的安装包打开浏览器访问 Azul Zulu 社区版的下载页面。你可以直接搜索 “Zulu JDK 8 download” 找到官网或者访问其核心下载站点。在版本选择中找到Java 8 (LTS)。通常会有多个更新版本如8u402选择最新的即可。关键步骤在操作系统Operating System中选择macOS在架构Architecture中选择ARM 64-bit。务必确认你选择的包是ARM 64-bit而不是x86 64-bit。选择安装包类型。这里我强烈推荐下载.dmg格式的安装包而不是.tar.gz。对于新手.dmg提供了图形化的安装向导会自动处理一些路径问题更省心。对于老手.tar.gz可以自定义安装路径灵活性更高。本例我们以.dmg为例。点击下载等待下载完成。3.2 安装DMG包在“下载”文件夹中找到下载的.dmg文件例如zulu8.74.0.17-ca-jdk8.0.402-macosx_aarch64.dmg双击打开。你会看到一个包含Zulu 8.pkg安装程序的磁盘映像窗口。双击这个.pkg文件。跟随图形化安装向导的提示进行操作点击“继续”阅读许可协议并同意选择安装目的地通常是你的Macintosh HD然后点击“安装”。系统可能会要求你输入管理员密码以授权安装。输入密码后安装程序会将JDK写入到系统的标准目录/Library/Java/JavaVirtualMachines/。安装完成后你可以在访达Finder中按CmdShiftG输入上述路径查看是否多了一个名为zulu-8.jdk的文件夹。这就是我们安装好的JDK。注意使用.pkg安装的一个好处是它会自动在/usr/libexec/java_home这个系统工具可识别的路径下注册这个JDK为后续多版本管理提供了便利。3.3 验证安装是否成功安装完成后我们首先验证JDK本身是否可用且是ARM原生版本。打开“终端”应用。输入以下命令查看Java编译器版本/usr/libexec/java_home -v 1.8 --exec javac -version这个命令的意思是找到版本号为1.8的JAVA_HOME然后在其bin目录下执行javac -version。如果安装正确你会看到类似javac 1.8.0_402的输出。更直接地我们可以进入安装目录直接运行/Library/Java/JavaVirtualMachines/zulu-8.jdk/Contents/Home/bin/java -version你应该看到包含“Zulu 8.74.0.17-CA-macos-aarch64”字样的输出。请务必确认输出中有aarch64这证明你运行的是ARM原生版本而不是通过Rosetta 2转译的x86版本。4. 环境变量配置让系统找到你的Java安装好JDK后我们需要配置环境变量让终端Shell知道去哪里找java,javac这些命令。Mac系统常用的Shell是zshmacOS Catalina及以后版本的默认Shell其配置文件是~/.zshrc。如果你还在使用老版本的bash配置文件则是~/.bash_profile。我个人的建议是统一使用~/.zshrc除非你有明确的理由使用bash。4.1 配置JAVA_HOME和PATHJAVA_HOME是一个指向JDK安装根目录的环境变量很多Java工具如Maven、Gradle、IDE都依赖它。PATH则决定了系统在哪些目录下寻找可执行命令。打开终端使用文本编辑器如nano或vim打开zsh的配置文件nano ~/.zshrc如果你更喜欢vim就用vim ~/.zshrc。在文件的末尾添加以下几行配置# Java Environment export JAVA_8_HOME$(/usr/libexec/java_home -v 1.8) export JAVA_HOME$JAVA_8_HOME export PATH$JAVA_HOME/bin:$PATHJAVA_8_HOME使用java_home工具动态地找到版本号为1.8的JDK路径。这是一个非常优雅的方式即使将来JDK安装路径因更新发生变化这里也无需修改。JAVA_HOME将当前默认的JAVA_HOME指向我们的Java 8。如果你想管理多个版本可以稍后调整这里。PATH将$JAVA_HOME/bin添加到PATH变量的最前面。这样当你在终端输入java时系统会优先使用我们设置的JDK 8下的命令。保存并退出编辑器。在nano中按Ctrl X然后按Y确认保存最后按Enter确认文件名。在vim中按Esc然后输入:wq再按Enter。让配置立即生效。在终端执行source ~/.zshrc4.2 验证环境变量配置执行以下命令来验证配置是否正确检查JAVA_HOMEecho $JAVA_HOME应该输出类似/Library/Java/JavaVirtualMachines/zulu-8.jdk/Contents/Home的路径。检查Java版本现在可以直接用简单命令java -version javac -version两者都应该正确显示Zulu 8的版本信息并且包含aarch64。实操心得很多教程会教你手动写死路径比如export JAVA_HOME/Library/Java/JavaVirtualMachines/zulu-8.jdk/Contents/Home。这当然可以但我强烈推荐使用$(/usr/libexec/java_home -v 1.8)这种动态获取的方式。它的好处是如果你以后通过.pkg安装了新版本的Java 8比如从8u402升级到8u412这个变量会自动指向新的路径无需你手动修改配置文件。这是Mac系统提供的一个非常实用的工具。5. 在IntelliJ IDEA中配置JDK环境变量配好了终端里可以用了但我们的主战场——IDE还需要单独配置。IntelliJ IDEA有自己独立的JDK配置管理。5.1 为项目配置JDK打开或创建一个Java项目。打开“项目结构”设置窗口。有两种方式快捷键Cmd ;Mac。菜单栏File - Project Structure...在左侧选择“Project”选项。在右侧的“Project SDK”下拉框旁边点击“New...”-“Add JDK...”。这会打开一个访达Finder窗口。你需要导航到JDK的安装根目录Home目录。最快的方式是按下Cmd Shift G。粘贴路径/Library/Java/JavaVirtualMachines然后前往。选择zulu-8.jdk文件夹点击“打开”。IDEA会自动识别并填充JDK名称如“1.8 (Zulu 8.74.0.17)”。点击“OK”。回到Project设置页面确保“Project SDK”已经选中了我们刚刚添加的Zulu 8。同时检查“Project language level”是否自动同步为“8”。点击“OK”或“Apply”保存。5.2 配置全局的默认JDK可选但推荐如果你希望所有新创建的项目都默认使用这个JDK 8可以进行全局配置。打开“偏好设置”Cmd ,。导航到Build, Execution, Deployment - Build Tools - Maven如果你用Maven或者Gradle如果你用Gradle。在这些工具的设置里找到“Importing”或“Runner”标签页将“JDK for importer”或“Gradle JVM”也修改为你刚刚添加的Zulu 8 JDK。这可以避免IDE在导入项目或执行构建时使用其他版本的JDK导致依赖解析或编译错误。更全局的设置是在“Build, Execution, Deployment - Compiler - Java Compiler”中但通常项目级别的设置优先级更高这里保持默认即可。5.3 验证IDEA中的JDK在IDEA中你可以通过多种方式验证JDK是否配置正确打开一个Java文件代码语法高亮和自动补正常。打开终端Terminal工具窗口View - Tool Windows - Terminal输入java -version应该显示与系统终端一致的Zulu 8信息。尝试运行一个简单的“Hello World”程序应该能成功编译和执行。踩坑记录我曾经遇到过在IDEA的“Project Structure”里添加JDK后运行项目时依然报错“找不到JDK”的情况。排查后发现是“Run/Debug Configurations”这个具体运行配置里依然指向了一个旧的、无效的JDK。解决方法点击IDEA右上角运行配置下拉菜单选择“Edit Configurations...”在对应的模板如Application中检查“JRE”选项是否指向了正确的“Project SDK”。这是一个容易忽略的细节点。6. 多版本Java管理进阶技巧在实际开发中我们很可能需要在不同项目间切换Java版本比如同时维护一个Java 8的老项目和一个Java 17的新项目。手动修改JAVA_HOME和PATH非常麻烦。这里介绍两个更优雅的管理工具。6.1 使用 jenv 进行版本管理jenv是一个轻量级的命令行工具可以让你轻松地在多个JDK版本间切换。安装 jenv如果你已经安装了Homebrew这是最简单的方brew install jenv将 jenv 集成到你的Shell根据你使用的Shell将初始化脚本添加到配置文件中。对于zshecho export PATH$HOME/.jenv/bin:$PATH ~/.zshrc echo eval $(jenv init -) ~/.zshrc source ~/.zshrc将已安装的JDK添加到 jenv# 添加我们安装的Zulu 8 jenv add /Library/Java/JavaVirtualMachines/zulu-8.jdk/Contents/Home # 如果你还安装了其他版本比如Java 17也类似地添加 # jenv add /Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home使用jenv versions可以查看所有已管理的版本前面带*的是当前全局使用的版本。切换版本设置全局版本jenv global 1.8设置当前Shell会话版本jenv shell 1.8设置特定目录项目的本地版本进入项目根目录执行jenv local 1.8。这会在当前目录创建一个.java-version文件以后进入这个目录jenv会自动切换为Java 8。jenv的优点配置简单切换无感特别适合需要频繁切换版本的用户。它通过创建垫片shims来覆盖系统命令非常轻量。6.2 使用IDE的SDK管理功能对于项目级别的版本管理IntelliJ IDEA自身的“Project Structure”设置已经足够强大。你可以为每个项目指定不同的“Project SDK”。当你打开不同的项目时IDEA会自动使用为该项目配置的JDK互不干扰。我的工作流我通常结合两者使用。在系统层面我使用jenv global设置一个默认版本比如较新的Java 17用于日常工具。对于特定的老项目我在其目录下使用jenv local 1.8。同时在IDEA中打开这个项目时确保“Project SDK”也指向同一个Java 8。这样无论是在IDEA内部运行还是在项目目录下打开终端执行Maven命令使用的都是正确的Java 8环境实现了完美的内外统一。7. 常见问题排查与解决方案即使按照步骤操作你也可能会遇到一些问题。这里列出几个我遇到过的典型问题及其解决方法。7.1 问题执行java -version显示的还是旧版本或x86版本症状配置了环境变量后在终端输入java -version输出的不是Zulu 8或者是类似Java(TM) SE Runtime Environment (build 1.8.0_401-b10)这种不带“Zulu”和“aarch64”的信息。原因与排查PATH顺序问题你的PATH变量中可能在其他路径如/usr/bin下有一个更早的java命令。Mac系统自带了/usr/bin/java它是一个指向系统默认Java的软链接。配置未生效你可能修改了错误的配置文件比如用了~/.bash_profile但终端是zsh或者修改后没有执行source命令。解决方案首先确认你修改的是~/.zshrc并且已source。然后使用which java命令查看当前生效的java命令路径。如果输出是/usr/bin/java说明系统自带的命令优先级更高。检查你的~/.zshrc中PATH的设置。确保$JAVA_HOME/bin被添加在了PATH的最前面。因为Shell查找命令是从PATH列表的前面往后找的。正确的写法是export PATH$JAVA_HOME/bin:$PATH而不是export PATH$PATH:$JAVA_HOME/bin。如果问题依旧可以尝试在终端先输入hash -r命令清除命令缓存再试。7.2 问题IDEA无法识别或添加JDK症状在IDEA的“Add JDK”窗口中选择了zulu-8.jdk文件夹后IDEA没有自动识别或者列表为空。原因与排查路径错误你可能导航到了错误的目录。JDK的“Home”目录是包含bin,lib,jre等子目录的那一层。对于.pkg安装的Zulu完整路径是/Library/Java/JavaVirtualMachines/zulu-8.jdk/Contents/Home。在“Add JDK”时你需要选择到Home这一级或者直接选择zulu-8.jdk文件夹IDEA通常会智能地找到Home。权限问题极少数情况下/Library/Java/JavaVirtualMachines/目录权限有问题。解决方案在“Add JDK”的访达窗口中直接使用CmdShiftG快捷键输入/Library/Java/JavaVirtualMachines前往然后选择zulu-8.jdk文件夹。如果还是不行可以尝试手动指定点击“Add JDK”窗口的“Create New...”按钮如果存在或者直接关闭窗口在“Project Structure”的SDK列表里点击“”号选择“Add JDK...”然后再次尝试。检查文件夹权限在终端执行ls -la /Library/Java/JavaVirtualMachines/确保你的用户有读取权限。7.3 问题运行项目时出现“不支持的Class版本”错误症状编译通过但运行时报错java.lang.UnsupportedClassVersionError: Unsupported major.minor version 52.0。原因这是最经典的版本不匹配错误。“major.minor version 52.0”对应的是Java 8编译的类文件。错误意味着你尝试用一个比Java 8更老的JRE比如Java 7去运行用Java 8编译的类。解决方案在M1 Mac上这种情况通常不是你主动安装了Java 7而是运行环境错误地指向了其他版本。在IDEA中确保“Project SDK”和“Run/Debug Configurations”里的“JRE”都设置为Java 8。在终端/命令行中使用java -version确认当前生效的版本。如果不对用jenv local 1.8或检查PATH和JAVA_HOME环境变量。7.4 问题某些依赖库在M1上无法运行或编译失败症状项目依赖的某个JAR包或原生库Native Library在运行时崩溃或编译时找不到符号。原因一些非常老旧的Java库可能包含了平台相关的原生代码.dylib, .so文件这些代码是为x86_64架构编译的无法在ARM64的M1上直接加载。解决方案寻找更新版本首先检查该库是否有更新的、支持ARM64的版本。使用Rosetta 2运行如果库必须使用且无ARM版本一个妥协方案是让整个JVM运行在Rosetta 2转译模式下。但这应该是最后的手段。对于终端命令在命令前加上arch -x86_64例如arch -x86_64 java -jar myapp.jar。对于IDEA你需要为IDEA应用本身启用Rosetta 2转译。在“应用程序”文件夹中找到IntelliJ IDEA右键点击 - “显示简介”勾选“使用Rosetta打开”。然后重启IDEA。注意这会让整个IDE运行在转译模式可能影响性能不推荐长期使用。经过以上步骤你应该已经在M1芯片的Mac上成功搭建了一个原生、高效且与IntelliJ IDEA完美集成的Java 8开发环境。这个环境足以应对绝大多数基于Java 8的企业级应用开发和维护工作。核心的体会是在架构过渡期主动选择像Azul Zulu这样提供良好ARM支持的发行版并善用jenv等版本管理工具能极大提升开发体验和效率避免陷入各种兼容性问题的泥潭。