MacBook Air (macOS) Java 开发环境+日常软件完整搭建指南

一、软件清单总览

二、详细安装步骤

1. 安装 Homebrew（macOS 包管理神器）

Homebrew 是 macOS 最常用的包管理器，后续大部分软件均可通过它快速安装，避免手动配置环境变量。

安装命令

打开 macOS 自带的「终端」（或后续安装的 iTerm2），执行：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

验证安装

brew -v
# 输出类似：Homebrew 4.2.1（版本号不同正常）

（可选）解决国内访问慢的问题

若安装/更新慢，替换为国内源（清华镜像）：

# 临时生效（单次终端会话）
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"
export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git"

# 永久生效（写入 zsh 配置）
echo 'export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"' >> ~/.zshrc
echo 'export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git"' >> ~/.zshrc
source ~/.zshrc

2. 安装 JDK（推荐 JDK 17/8/21，按需选择）

macOS 下推荐通过 Homebrew 安装 Adoptium（Eclipse Temurin）JDK（开源免费，兼容 Oracle JDK）。

步骤1：查找可用 JDK 版本

brew search temurin
# 输出：temurin8、temurin11、temurin17、temurin21 等

步骤2：安装指定版本（示例：JDK 17，主流 LTS 版本）

# 安装 JDK 17
brew install temurin17

# 若需要 JDK 8（兼容老项目）
# brew install temurin8

步骤3：验证安装

java -version
# 输出示例：
# openjdk version "17.0.9" 2023-10-17 LTS
# OpenJDK Runtime Environment Temurin-17.0.9+9 (build 17.0.9+9-LTS)
# OpenJDK 64-Bit Server VM Temurin-17.0.9+9 (build 17.0.9+9-LTS, mixed mode, sharing)

javac -version
# 输出：javac 17.0.9

步骤4：配置 JAVA_HOME（关键，避免 IDE 识别不到）

macOS 下 Homebrew 安装的 JDK 路径为 /Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home（版本号对应），需配置到环境变量：

# 编辑 zsh 配置文件（macOS 新版默认 shell 是 zsh）
vim ~/.zshrc

# 添加以下内容（JDK 17 示例，若为 8 则替换为 temurin-8.jdk）
export JAVA_HOME=/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home
export PATH=$JAVA_HOME/bin:$PATH

# 保存并生效配置
source ~/.zshrc

# 验证 JAVA_HOME
echo $JAVA_HOME
# 输出：/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home

多 JDK 切换（可选）

若需同时使用多个 JDK，安装 jenv 管理：

brew install jenv
echo 'export PATH="$HOME/.jenv/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(jenv init -)"' >> ~/.zshrc
source ~/.zshrc

# 将安装的 JDK 加入 jenv
jenv add /Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home
jenv add /Library/Java/JavaVirtualMachines/temurin-8.jdk/Contents/Home

# 全局切换 JDK 版本
jenv global 17
# 局部（当前目录）切换
jenv local 8

3. 安装 Maven

步骤1：通过 Homebrew 安装

brew install maven

步骤2：验证安装

mvn -v
# 输出示例：
# Apache Maven 3.9.6 (bc0240f3c744dd6b6ec2920b3cd08dcc295161ae)
# Maven home: /opt/homebrew/Cellar/maven/3.9.6/libexec
# Java version: 17.0.9, vendor: Eclipse Adoptium, runtime: /Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home

步骤3：配置 Maven（核心：镜像 + 本地仓库）

# 1. 找到 Maven 配置文件路径
mvn -v | grep "Maven home"
# 输出：Maven home: /opt/homebrew/Cellar/maven/3.9.6/libexec
# 配置文件路径：/opt/homebrew/Cellar/maven/3.9.6/libexec/conf/settings.xml

# 2. 复制配置文件到用户目录（避免修改系统文件）
mkdir -p ~/.m2
cp /opt/homebrew/Cellar/maven/3.9.6/libexec/conf/settings.xml ~/.m2/

# 3. 编辑用户目录下的 settings.xml（配置阿里云镜像，加速依赖下载）
vim ~/.m2/settings.xml

在 <mirrors> 标签内添加阿里云镜像：

<mirror>
    <id>aliyunmaven</id>
    <mirrorOf>central</mirrorOf>
    <url>https://maven.aliyun.com/repository/public</url>
</mirror>

可选：配置本地仓库路径（默认 ~/.m2/repository），在 <settings> 标签内添加：

<localRepository>/Users/你的用户名/.m2/repository</localRepository>

4. 安装 Git

步骤1：通过 Homebrew 安装

brew install git

步骤2：验证安装

git --version
# 输出：git version 2.43.0

步骤3：配置 Git 全局信息（必做）

# 配置用户名和邮箱（关联远程仓库，如 GitHub/GitLab）
git config --global user.name "你的用户名"
git config --global user.email "你的邮箱@xxx.com"

# 配置默认分支为 main（兼容 GitHub 新版）
git config --global init.defaultBranch main

# 配置免密拉取/推送（HTTPS 方式）
git config --global credential.helper osxkeychain

# 查看配置
git config --global --list

（可选）安装 Git Flow

brew install git-flow-avh
# 验证
git flow version

5. 安装 IntelliJ IDEA

方式1：通过官网下载（推荐，获取最新版）

1. 访问 IntelliJ IDEA 官网；
2. 下载「Community」（社区版，免费）或「Ultimate」（旗舰版，需激活）；
3. 解压下载的 .dmg 文件，将 IntelliJ IDEA.app 拖入「应用程序」文件夹；
4. 打开 IDEA，首次启动选择「Do not import settings」，按引导完成初始化。

方式2：通过 Homebrew 安装（便捷）

# 安装 IDEA 社区版
brew install --cask intellij-idea-ce

# 安装旗舰版
# brew install --cask intellij-idea

IDEA 关键配置（必做）

1. 配置 JDK：
   打开 IDEA → File → Project Structure → Platform Settings → SDKs → 点击 + → 选择 JDK → 指向 /Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home。
2. 配置 Maven：
   File → Settings → Build, Execution, Deployment → Build Tools → Maven →
   • Maven home directory：选择 /opt/homebrew/Cellar/maven/3.9.6/libexec（通过 mvn -v 查看）；
   • User settings file：选择 ~/.m2/settings.xml；
   • Local repository：选择 ~/.m2/repository。
3. 配置 Git：
   File → Settings → Version Control → Git → Path to Git executable 选择 /opt/homebrew/bin/git（通过 which git 查看）。

6. 安装 iTerm2（增强终端，可选）

brew install --cask iterm2

推荐配置

• 安装 Oh My Zsh：sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"；
• 更换主题：编辑 ~/.zshrc，修改 ZSH_THEME="agnoster"（推荐主题：agnoster、powerlevel10k）；
• 安装字体：Meslo Nerd Font，iTerm2 中设置 Preferences → Profiles → Text → Font 选择该字体。

7. 安装 Docker（可选）

brew install --cask docker

打开 Docker.app，等待启动完成后，验证：

docker --version
docker-compose --version

8. 安装 Postman（API 调试工具）

方式1：Homebrew 安装（便捷）

brew install --cask postman

方式2：官网下载（备选）

1. 访问 Postman 官网，自动识别 macOS 版本并下载；
2. 解压下载的 .zip 包，将 Postman.app 拖入「应用程序」文件夹；
3. 启动后可跳过登录，直接使用离线模式调试接口。

9. 安装 XMind Manager（思维导图工具）

步骤1：下载安装包

访问 XMind 官网，下载 macOS 版本的 .dmg 安装包。

步骤2：安装

1. 双击 .dmg 文件，将 XMind 图标拖拽到「应用程序」文件夹；
2. 若提示“文件损坏”，终端执行以下命令（解除系统限制）：

sudo xattr -rd com.apple.quarantine /Applications/XMind.app

步骤3：启动配置

从启动台打开 XMind，完成初始引导后即可创建思维导图，支持开发需求梳理、技术架构规划等场景。

10. 安装 Draw.io（流程图/架构图工具）

方式1：Homebrew 安装

brew install --cask drawio

方式2：官网下载

1. 访问 Draw.io 官网，点击顶部 Download，选择 macOS 版本；
2. 解压 .dmg 包，将 draw.io.app 拖入「应用程序」文件夹；
3. 启动后可选择本地文件存储或云端（OneDrive/Google Drive）存储流程图，支持绘制架构图、时序图、流程图等。

11. 安装搜狗输入法（中文输入法）

步骤1：下载安装包

访问 搜狗输入法官网，下载 macOS 版本的 .dmg 安装包。

步骤2：安装

1. 双击 .dmg 文件，将搜狗输入法图标拖入「应用程序」文件夹；
2. 打开搜狗输入法，按提示完成系统权限授权（设置 → 隐私与安全性 → 允许搜狗输入法访问）。

步骤3：配置

1. 打开「系统设置 → 键盘 → 输入法」；
2. 点击左下角 +，添加「搜狗拼音输入法」；
3. （可选）设置切换快捷键：点击「输入法快捷键」，将「切换输入法」设置为 Command + 空格。

12. 安装微信（日常沟通）

方式1：App Store 安装（推荐）

1. 打开 App Store，搜索「微信」；
2. 点击「获取」，输入 Apple ID 密码或验证面容/指纹完成安装。

方式2：官网下载

1. 访问 微信 macOS 官网，下载 .dmg 安装包；
2. 解压后将「微信.app」拖入「应用程序」文件夹；
3. 启动后扫码登录，可开启「自动登录」方便后续使用。

13. 安装网易云音乐（日常娱乐）

方式1：App Store 安装

1. 打开 App Store，搜索「网易云音乐」；
2. 点击「获取」完成安装。

方式2：官网下载

1. 访问 网易云音乐官网，下载 macOS 版本的 .dmg 安装包；
2. 解压后将「网易云音乐.app」拖入「应用程序」文件夹；
3. 启动后登录账号，支持离线下载、歌单同步等功能。

14. 安装 DBeaver（数据库客户端，可选）

brew install --cask dbeaver-community

启动后可配置 MySQL、PostgreSQL、Oracle 等数据库连接，支持可视化操作数据库。

15. 安装 Visual Studio Code（轻量编辑器，可选）

brew install --cask visual-studio-code

推荐安装 Java 相关插件

• Extension Pack for Java
• Maven for Java
• Git History
• Chinese (Simplified) Language Pack（中文语言包）

三、环境验证（最终检查）

执行以下命令，确保核心开发工具正常：

# 1. JDK
java -version && javac -version && echo $JAVA_HOME

# 2. Maven
mvn -v

# 3. Git
git --version && git config --global --list

# 4. 其他工具验证
# 打开 IDEA/Postman/Draw.io/微信 等软件，确认启动正常

四、常见问题解决

1. Homebrew 安装失败：
   检查网络，或使用国内镜像脚本：/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"。
2. JAVA_HOME 配置不生效：
   确认 shell 类型（echo $SHELL），若为 bash 则编辑 ~/.bash_profile 而非 ~/.zshrc。
3. IDEA 识别不到 JDK/Maven：
   重启 IDEA，或在 File → Invalidate Caches / Restart 清理缓存后重试。
4. Maven 依赖下载慢：
   确认 settings.xml 中阿里云镜像配置正确，或检查网络代理。
5. 第三方软件提示“无法打开”：
   终端执行 sudo xattr -rd com.apple.quarantine /Applications/软件名称.app，解除系统安全限制。
6. 输入法切换失效：
   重启电脑，或在「系统设置 → 键盘 → 输入法」中移除并重新添加搜狗输入法。