Mac 下 Java 開發環境配置全攻略：JDK、Tomcat、MySQL、IDE 一站式搭建

Mac 作為開發主力機，Java 環境搭建有別於 Windows。本文提供 2024 年適用的標準化流程：Homebrew 包管理、JDK 多版本切換、Tomcat 部署、MySQL 安裝、IDE 配置、環境變量持久化，避開常見坑點（Apple Silicon 兼容、權限、路徑差異）。

核心工具：Homebrew（必裝）

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

後續所有軟件優先 brew install，自動處理依賴、路徑、更新。

第一步：JDK 多版本管理

1.1 安裝 JDK（推薦 Temurin/OpenJDK）

# 安裝 LTS 版本
brew install --cask temurin@17
brew install --cask temurin@21

# 或安裝最新版
brew install openjdk

1.2 配置環境變量（~/.zshrc / ~/.bash_profile）

# JDK 根目錄規律：/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home
export JAVA_17_HOME="/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home"
export JAVA_21_HOME="/Library/Java/JavaVirtualMachines/temurin-21.jdk/Contents/Home"

# 默認使用 17
export JAVA_HOME=$JAVA_17_HOME
export PATH=$JAVA_HOME/bin:$PATH

# 快速切換函數
jdk() {
    case $1 in
        17) export JAVA_HOME=$JAVA_17_HOME ;;
        21) export JAVA_HOME=$JAVA_21_HOME ;;
        *) echo "Usage: jdk 17|21" ;;
    esac
    export PATH=$JAVA_HOME/bin:$PATH
    java -version
}

執行 source ~/.zshrc 生效，終端輸入 jdk 21 即可切換。

1.3 驗證

java -version
javac -version
echo $JAVA_HOME

第二步：Tomcat 部署

2.1 安裝

brew install tomcat@9   # 或 tomcat@10 (Jakarta EE 9)
# 安裝路徑：/opt/homebrew/Cellar/tomcat@9/9.0.xx (Apple Silicon)
# 或 /usr/local/Cellar/... (Intel)

2.2 環境變量與啟動

export CATALINA_HOME=$(brew --prefix tomcat@9)/libexec
export PATH=$CATALINA_HOME/bin:$PATH

# 啟動/停止
catalina start   # 前台運行，日誌直輸終端
catalina stop
catalina run     # 調試模式

2.3 配置端口與內存

編輯 $CATALINA_HOME/conf/server.xml 修改端口（默認 8080）。

創建 $CATALINA_HOME/bin/setenv.sh 設置 JVM 參數：

export CATALINA_OPTS="-Xms512m -Xmx2g -XX:MetaspaceSize=256m -XX:MaxMetaspaceSize=512m"

2.4 驗證

瀏覽器 https://localhost:8080 出現貓咪頁面即成功。

第三步：MySQL 安裝配置

3.1 安裝

brew install mysql@8.0
brew services start mysql@8.0  # 註冊為 launchd 服務，開機自啟

3.2 初始化安全設置

mysql_secure_installation
# 設置 root 密碼、移除匿名用戶、禁止遠程 root 登錄、刪除 test 庫

3.3 連接測試

mysql -u root -p
# 或用 GUI：DataGrip、DBeaver、Sequel Ace (Mac 專用免費)

3.4 常用配置（/opt/homebrew/etc/my.cnf 或 /usr/local/etc/my.cnf）

[mysqld]
character-set-server=utf8mb4
collation-server=utf8mb4_unicode_ci
default-time-zone='+08:00'
max_connections=1000
innodb_buffer_pool_size=1G

第四步：IDE 配置

第五步：Maven / Gradle

brew install maven
brew install gradle
# 配置阿里云鏡像 ~/.m2/settings.xml
# Gradle 用戶編輯 ~/.gradle/init.gradle 設置鏡像

常見坑點避雷

總結

Mac 下 Java 環境核心口訣：Homebrew 統一包管理、JAVA_HOME 手動導出並寫入 Shell 配置、多版本切換函數、Tomcat/MySQL 用 brew services 托管、IDE 手動指定 JDK 路徑。Apple Silicon 時代，務必選 arm64 原生構建，性能翻倍且無 Rosetta 2 兼容性問題。配置腳本化存入 Git 倉庫，新機器 git clone && ./setup.sh 一鍵上手。

1. 上一篇文章： Java 類加載全流程深度解析：加載、驗證、準備、解析、初始化五階段詳解
2. 下一篇文章： Java 連接 Oracle/MySQL 數據庫：JDBC 標準三步走、驅動下載、連接字符串詳解

Java 相關知識

Java 入門學習路徑指南：Greenfoot → BlueJ → NetBeans 的漸進式工具鏈

前言：工具選型決定學習體驗 Java 技術棧龐大，初學者易迷

Eclipse Galileo 补丁應用全解析：從創建到衝突解決的團隊協作實戰

Eclipse 團隊開發中，補丁是跨倉庫、跨團隊、跨版本共享

Eclipse + PyDev 解決 Python 代碼中文編碼問題完整指南

問題背景 Eclipse + PyDev 開發 Python

Java 多執行緒第三種建立方式：Callable、Future 與 CompletionService 實戰

繼承 Thread、實作 Runnable 之外，Java