M1 Mac 新机开箱第一步：保姆级 Java + VSCode 开发环境搭建（含阿里云 Maven 镜像配置）
M1 Mac 新机开箱第一步：保姆级 Java + VSCode 开发环境搭建（含阿里云 Maven 镜像配置）
刚拿到崭新的 M1 Mac，第一件事就是配置开发环境。作为 Java 开发者，我们需要一套完整、高效的工具链来快速投入工作。本文将手把手带你完成从零开始的 Java 开发环境搭建，特别针对 M1 芯片优化，并包含阿里云 Maven 镜像加速等实用技巧。
1. 准备工作与 M1 芯片特性
M1 芯片采用 ARM 架构，这意味着我们需要特别注意软件兼容性。与传统 Intel Mac 不同，部分软件需要专门为 ARM 架构编译的版本才能发挥最佳性能。
关键检查点：
- 确认你的 Mac 使用 Apple Silicon 芯片：点击左上角苹果图标 → "关于本机" → 查看"芯片"是否为 Apple M1
- 确保系统更新至最新版本：系统偏好设置 → 软件更新
提示：虽然 Rosetta 2 可以运行 x86 软件，但建议尽可能使用原生 ARM 版本以获得最佳性能和电池续航。
2. JDK 安装与配置
2.1 选择合适的 JDK 版本
对于 M1 Mac，我们推荐以下 JDK 发行版：
| 发行商 | 版本推荐 | ARM 支持 | 下载方式 |
|---|---|---|---|
| Azul Zulu | 8/11/17 | 原生支持 | .dmg 安装包 |
| Amazon Corretto | 8/11/17 | 原生支持 | .pkg 安装包 |
| OpenJDK | 最新LTS | 原生支持 | 手动安装 |
建议选择长期支持(LTS)版本，如 Java 11 或 17，以获得更好的稳定性和社区支持。
2.2 安装步骤
- 访问 Azul Zulu 下载页面
- 选择 "macOS" → "ARM 64-bit" → 需要的 JDK 版本
- 下载 .dmg 文件并双击安装
- 按照向导完成安装，通常默认位置为
/Library/Java/JavaVirtualMachines/
验证安装：
java -version应显示类似：
openjdk version "17.0.3" 2022-04-19 LTS OpenJDK Runtime Environment Zulu17.34+19-CA (build 17.0.3+7-LTS) OpenJDK 64-Bit Server VM Zulu17.34+19-CA (build 17.0.3+7-LTS, mixed mode, sharing)2.3 环境变量配置
编辑~/.zshrc文件（M1 Mac 默认使用 zsh）：
nano ~/.zshrc添加以下内容：
# Java Environment export JAVA_HOME=$(/usr/libexec/java_home -v 17) # 17 替换为你安装的版本 export PATH=$JAVA_HOME/bin:$PATH保存后执行：
source ~/.zshrc3. Maven 安装与阿里云镜像配置
3.1 安装 Maven
- 访问 Maven 官网
- 下载最新二进制 tar.gz 文件（如 apache-maven-3.8.6-bin.tar.gz）
- 解压到合适位置，如
~/Development/tools/
mkdir -p ~/Development/tools tar -xzf apache-maven-3.8.6-bin.tar.gz -C ~/Development/tools/3.2 配置环境变量
编辑~/.zshrc添加：
# Maven Environment export MAVEN_HOME=~/Development/tools/apache-maven-3.8.6 export PATH=$MAVEN_HOME/bin:$PATH验证安装：
mvn -v3.3 配置阿里云镜像
编辑$MAVEN_HOME/conf/settings.xml，在<mirrors>部分添加：
<mirror> <id>aliyunmaven</id> <mirrorOf>*</mirrorOf> <name>阿里云公共仓库</name> <url>https://maven.aliyun.com/nexus/content/groups/public/</url> </mirror>同时配置本地仓库位置（可选）：
<localRepository>~/Development/maven_repository</localRepository>4. VSCode 配置与 Java 开发
4.1 安装 VSCode
- 下载 VSCode for Apple Silicon
- 拖动到 Applications 文件夹完成安装
4.2 必备插件安装
- Java Extension Pack(Microsoft)：包含 Java 开发全套工具
- Maven for Java(Microsoft)：Maven 项目支持
- Lombok Annotations Support：Lombok 注解支持
- Spring Boot Extension Pack(如开发 Spring 项目)
4.3 配置 Java 环境
- 打开命令面板 (⌘⇧P)
- 输入 "Java: Configure Java Runtime"
- 确认检测到的 JDK 路径正确
4.4 创建并运行 Java 项目
- 创建新文件夹作为项目目录
- 在 VSCode 中打开该文件夹
- 创建
src/main/java/com/example/Main.java文件：
package com.example; public class Main { public static void main(String[] args) { System.out.println("Hello, M1 Mac!"); } }- 按 F5 运行程序，选择 "Java" 环境
提示：首次运行会自动生成 .vscode/launch.json 配置文件
5. 进阶配置与优化
5.1 多版本 JDK 管理
使用 jenv 管理多个 JDK 版本：
brew install jenv jenv add $(/usr/libexec/java_home -v 17) jenv add $(/usr/libexec/java_home -v 11) jenv global 175.2 性能调优
针对 M1 芯片优化 JVM 参数：
-XX:+UseZGC -Xmx2g -Xms2g5.3 常用工具推荐
- Homebrew：包管理工具
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"- iTerm2：更强大的终端
- DBeaver：数据库管理工具
6. 常见问题排查
问题1：Java 程序运行缓慢
解决方案：确认使用 ARM 原生 JDK 而非通过 Rosetta 运行
问题2：Maven 下载依赖失败
检查步骤：
- 确认 settings.xml 中阿里云镜像配置正确
- 检查网络连接，尝试关闭 VPN 类软件
- 清理本地仓库并重试：
mvn dependency:purge-local-repository问题3：VSCode 无法识别 Java 项目
解决方案：
- 确保安装了 Java Extension Pack
- 重新加载窗口 (⌘⇧P → "Reload Window")
- 检查项目根目录是否有正确的 pom.xml 或 build.gradle
在实际使用中，我发现 M1 Mac 运行 Java 程序的性能表现非常出色，特别是使用原生 ARM 版 JDK 时。环境配置完成后，你可以立即开始高效的 Java 开发工作。