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 发行版：

建议选择长期支持(LTS)版本，如 Java 11 或 17，以获得更好的稳定性和社区支持。

2.2 安装步骤

1. 访问 Azul Zulu 下载页面
2. 选择 "macOS" → "ARM 64-bit" → 需要的 JDK 版本
3. 下载 .dmg 文件并双击安装
4. 按照向导完成安装，通常默认位置为/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 ~/.zshrc

3. Maven 安装与阿里云镜像配置

3.1 安装 Maven

1. 访问 Maven 官网
2. 下载最新二进制 tar.gz 文件（如 apache-maven-3.8.6-bin.tar.gz）
3. 解压到合适位置，如~/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 -v

3.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

1. 下载 VSCode for Apple Silicon
2. 拖动到 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 环境

1. 打开命令面板 (⌘⇧P)
2. 输入 "Java: Configure Java Runtime"
3. 确认检测到的 JDK 路径正确

4.4 创建并运行 Java 项目

1. 创建新文件夹作为项目目录
2. 在 VSCode 中打开该文件夹
3. 创建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!"); } }

4. 按 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 17

5.2 性能调优

针对 M1 芯片优化 JVM 参数：

-XX:+UseZGC -Xmx2g -Xms2g

5.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 下载依赖失败
检查步骤：

1. 确认 settings.xml 中阿里云镜像配置正确
2. 检查网络连接，尝试关闭 VPN 类软件
3. 清理本地仓库并重试：

mvn dependency:purge-local-repository

问题3：VSCode 无法识别 Java 项目
解决方案：

1. 确保安装了 Java Extension Pack
2. 重新加载窗口 (⌘⇧P → "Reload Window")
3. 检查项目根目录是否有正确的 pom.xml 或 build.gradle

在实际使用中，我发现 M1 Mac 运行 Java 程序的性能表现非常出色，特别是使用原生 ARM 版 JDK 时。环境配置完成后，你可以立即开始高效的 Java 开发工作。