您现在的位置：程式碼之家 >> 編程語言 > >> Java 程式設計 >> Java 綜合教學

Mac 開發環境從零構建：JDK、Maven、Git、Eclipse 完整配置指南

編輯：Java 綜合教學

Mac 開發環境從零構建：JDK、Maven、Git、Eclipse 完整配置指南

Mac 作為類 Unix 系統，與 Linux 高度相似，但與 Windows 在路徑、終端、環境變量配置上差異巨大。本文針對 Java 開發者，提供JDK 驗證、Maven 安裝配置、Git 使用、Eclipse 整合的完整圖文教程，並解決 Mac 特有的快捷鍵衝突、隱藏檔案顯示、vi 編輯器等實操痛點。

一、JDK：系統自帶，無需額外安裝

macOS 預裝 JDK（通常為 1.8 或 11+）。驗證方式：

打開終端：Command+Space → 輸入「終端」/「Terminal」
執行：java -version

java version "1.8.0_XXX"
Java(TM) SE Runtime Environment (build 1.8.0_XXX-bXX)
Java HotSpot(TM) 64-Bit Server VM (build XX.XX-bXX, mixed mode)

注意：若需多版本切換，建議安裝 jEnv 或 SDKMAN! 管理。

二、Maven：手動安裝與環境變量配置

1. 下載解壓

官網下載 `apache-maven-3.x.x-bin.tar.gz`，解壓至自定目錄（如 `/Users/yourname/tools/apache-maven-3.9.6`）。

2. 配置 settings.xml

編輯 `conf/settings.xml`：

本地倉庫：`/Users/yourname/.m2/repository`（Mac 預設即此，可不改）。

私服鏡像（阿里雲）：

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

3. 環境變量永久生效（~/.bash_profile 或 ~/.zshrc）

Mac 現代版本預設 Shell 為 zsh，配置檔為 `~/.zshrc`；舊版或手動切換 bash 為 `~/.bash_profile`。

# 1. 檢查當前 Shell
echo $SHELL
# /bin/zsh → 編輯 ~/.zshrc
# /bin/bash → 編輯 ~/.bash_profile

# 2. 編輯對應檔案（以 zsh 為例）
vi ~/.zshrc

# 3. 加入以下內容
export MAVEN_HOME=/Users/yourname/tools/apache-maven-3.9.6
export PATH=$MAVEN_HOME/bin:$PATH

# 4. 立即生效
source ~/.zshrc

# 5. 驗證
mvn -v

環境變量配置示意

vi 編輯 ~/.bash_profile

三、Git：系統自帶，配置身份即可

# 驗證版本
git --version

# 全域配置使用者資訊（必做）
git config --global user.name "Your Name"
git config --global user.email "you@example.com"

# 常用別名（建議）
git config --global alias.st status
git config --global alias.co checkout
git config --global alias.br branch
git config --global alias.ci commit
git config --global alias.lg "log --oneline --graph --all"

後續所有 Git 操作（clone、commit、push、pull、branch、merge）均在終端直接執行，與 Linux 一致。

四、Eclipse：安裝、Maven 整合、工作區優化

1. 安裝

官網下載 `Eclipse IDE for Enterprise Java Developers` macOS 版（`.dmg`），雙擊安裝至 `Applications`。

2. 整合 Maven

啟動 Eclipse → 選單 Eclipse → Preferences（Mac 稱「偏好設定」，非 Windows 的「視窗→偏好設定」）
搜索「Maven」→ User Settings → `Global Settings` 與 `User Settings` 均指向你的 `settings.xml` 路徑
本地倉庫無需額外配置，Eclipse 會自動讀取 `settings.xml` 中的 `` 或預設 `~/.m2/repository`

3. 推荐優化設置

編碼：General → Workspace → Text file encoding = UTF-8
自動建構：General → Workspace → 勾選 Build automatically
JDK 合規性：Java → Compiler → Compiler compliance level = 1.8/11/17（專案需求）
保存動作：Java → Editor → Save Actions → 勾選 Format source code + Organize imports

五、Mac 實操必備技巧

痛點	解決方案
`Command`+`Space` 與輸入法切換衝突	系統偏好設定 → 鍵盤 → 快捷鍵 → 輸入法 → 取消勾選或改鍵；Spotlight 搜尋改用 `Command`+`Option`+`Space`
終端顯示隱藏檔案	`ls -a` 顯示所有；Finder 按 `Command`+`Shift`+`.` 切換隱藏檔可見性
vi 編輯器基本操作	`vi file` → `i` 進入插入模式 → 編輯 → `Esc` 退出插入 → `:wq` 存檔離開 / `:q!` 不存離開
路徑差異	Mac 家目錄 `~` = `/Users/username/`；Windows `C:\Users\username\`
執行 .sh 腳本權限	`chmod +x script.sh && ./script.sh`

六、後續規劃（MySQL、Navicat、Docker 等）

本文涵蓋 Java 核心開發鏈。資料庫類工具安裝：

MySQL：官網下載 `.dmg` 安裝包，或 `brew install mysql`（推薦 Homebrew 管理）
Navicat：官網下載 Mac 版試用/購買
Docker：Docker Desktop for Mac（含 Kubernetes）
Homebrew：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" —— Mac 套件管理神器，強烈建議優先安裝

結語

Mac 開發環境核心在於終端驅動、環境變量配置正確、工具鏈版本管理。掌握 `~/.zshrc`/`~/.bash_profile` 配置、Homebrew 套件管理、vi 基本編輯、快捷鍵衝突解決，能讓你在 Mac 上獲得媲美甚至優於 Linux 的 Java 開發體驗。建議將常用配置、別名、腳本整理成個人 dotfiles 專案托管至 GitHub，換機/重裝一鍵恢復。