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 Zulu8/11/17原生支持.dmg 安装包Amazon Corretto8/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.3419-CA (build 17.0.37-LTS) OpenJDK 64-Bit Server VM Zulu17.3419-CA (build 17.0.37-LTS, mixed mode, sharing)2.3 环境变量配置编辑~/.zshrc文件M1 Mac 默认使用 zshnano ~/.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 idaliyunmaven/id mirrorOf*/mirrorOf name阿里云公共仓库/name urlhttps://maven.aliyun.com/nexus/content/groups/public//url /mirror同时配置本地仓库位置可选localRepository~/Development/maven_repository/localRepository4. VSCode 配置与 Java 开发4.1 安装 VSCode下载 VSCode for Apple Silicon拖动到 Applications 文件夹完成安装4.2 必备插件安装Java Extension Pack(Microsoft)包含 Java 开发全套工具Maven for Java(Microsoft)Maven 项目支持Lombok Annotations SupportLombok 注解支持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. 常见问题排查问题1Java 程序运行缓慢解决方案确认使用 ARM 原生 JDK 而非通过 Rosetta 运行问题2Maven 下载依赖失败检查步骤确认 settings.xml 中阿里云镜像配置正确检查网络连接尝试关闭 VPN 类软件清理本地仓库并重试mvn dependency:purge-local-repository问题3VSCode 无法识别 Java 项目解决方案确保安装了 Java Extension Pack重新加载窗口 (⌘⇧P → Reload Window)检查项目根目录是否有正确的 pom.xml 或 build.gradle在实际使用中我发现 M1 Mac 运行 Java 程序的性能表现非常出色特别是使用原生 ARM 版 JDK 时。环境配置完成后你可以立即开始高效的 Java 开发工作。
M1 Mac 新机开箱第一步：保姆级 Java + VSCode 开发环境搭建（含阿里云 Maven 镜像配置）
发布时间：2026/6/14 9:35:00
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 Zulu8/11/17原生支持.dmg 安装包Amazon Corretto8/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.3419-CA (build 17.0.37-LTS) OpenJDK 64-Bit Server VM Zulu17.3419-CA (build 17.0.37-LTS, mixed mode, sharing)2.3 环境变量配置编辑~/.zshrc文件M1 Mac 默认使用 zshnano ~/.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 idaliyunmaven/id mirrorOf*/mirrorOf name阿里云公共仓库/name urlhttps://maven.aliyun.com/nexus/content/groups/public//url /mirror同时配置本地仓库位置可选localRepository~/Development/maven_repository/localRepository4. VSCode 配置与 Java 开发4.1 安装 VSCode下载 VSCode for Apple Silicon拖动到 Applications 文件夹完成安装4.2 必备插件安装Java Extension Pack(Microsoft)包含 Java 开发全套工具Maven for Java(Microsoft)Maven 项目支持Lombok Annotations SupportLombok 注解支持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. 常见问题排查问题1Java 程序运行缓慢解决方案确认使用 ARM 原生 JDK 而非通过 Rosetta 运行问题2Maven 下载依赖失败检查步骤确认 settings.xml 中阿里云镜像配置正确检查网络连接尝试关闭 VPN 类软件清理本地仓库并重试mvn dependency:purge-local-repository问题3VSCode 无法识别 Java 项目解决方案确保安装了 Java Extension Pack重新加载窗口 (⌘⇧P → Reload Window)检查项目根目录是否有正确的 pom.xml 或 build.gradle在实际使用中我发现 M1 Mac 运行 Java 程序的性能表现非常出色特别是使用原生 ARM 版 JDK 时。环境配置完成后你可以立即开始高效的 Java 开发工作。
