macOS开发环境配置

macOS是许多开发者的首选平台，它结合了类Unix系统的强大功能和优雅的用户界面。本指南将详细介绍如何在macOS上配置Java、Maven、Node.js等开发环境。

前置准备

安装Homebrew

Homebrew是macOS上强大的包管理工具，可以极大地简化软件安装过程：

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

# 验证安装
brew --version

安装命令行开发工具

xcode-select --install

Java开发环境配置

JDK安装与配置

macOS上有多种安装JDK的方法，以下介绍最常用的几种。

方法一：使用Homebrew安装OpenJDK

# 添加AdoptOpenJDK tap
brew tap adoptopenjdk/openjdk

# 查看可用版本
brew search adoptopenjdk

# 安装JDK 17
brew install --cask adoptopenjdk17

# 或者安装Temurin JDK（推荐）
brew install --cask temurin17

方法二：使用官方安装包

  1. 访问Oracle官方下载页面或Eclipse Temurin下载macOS版本的JDK
  2. 下载.pkg安装包文件
  3. 双击安装包，按照提示完成安装

JDK环境配置

macOS安装JDK后通常会自动配置环境变量，但手动配置也很简单：

# 查找JDK安装位置
/usr/libexec/java_home -V

# 配置环境变量，编辑shell配置文件
nano ~/.zshrc  # 对于macOS Catalina及以上版本
# 或者
# nano ~/.bash_profile  # 对于较旧的macOS版本

添加以下内容：

export JAVA_HOME=$(/usr/libexec/java_home -v 17)
export PATH=$JAVA_HOME/bin:$PATH

使配置生效：

source ~/.zshrc  # 或 source ~/.bash_profile

验证Java安装

java -version
javac -version

Maven安装与配置

使用Homebrew安装Maven

brew install maven

# 验证安装
mvn -version

手动安装Maven

  1. 下载Maven二进制包

  2. 解压到指定目录：

    tar -xzvf apache-maven-3.9.5-bin.tar.gz
sudo mv apache-maven-3.9.5 /usr/local/

  3. 配置环境变量：

    nano ~/.zshrc  # 或 ~/.bash_profile

    添加以下内容：

    export M2_HOME=/usr/local/apache-maven-3.9.5
export PATH=$PATH:$M2_HOME/bin

  4. 使配置生效：

    source ~/.zshrc  # 或 source ~/.bash_profile

  5. 验证安装：

    mvn -version

配置Maven设置

创建或编辑~/.m2/settings.xml文件：

mkdir -p ~/.m2
nano ~/.m2/settings.xml

添加国内镜像以加速下载（可选）：

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

Node.js开发环境配置

方法一：使用Homebrew安装

brew install node

# 验证安装
node -v
npm -v

方法二：使用nvm安装（推荐）

NVM允许管理多个Node.js版本：

# 安装nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash

# 配置环境变量
nano ~/.zshrc  # 或 ~/.bash_profile

添加以下内容（如果安装脚本没有自动添加）：

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # 加载nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # 加载nvm bash_completion

使配置生效：

source ~/.zshrc  # 或 source ~/.bash_profile

安装和使用Node.js：

# 安装最新LTS版本
nvm install --lts

# 或安装特定版本
nvm install 18.12.0

# 使用已安装的版本
nvm use --lts

# 设置默认版本
nvm alias default 'lts/*'

配置npm镜像（可选）

npm config set registry https://registry.npmmirror.com

IDE安装

Visual Studio Code

# 使用Homebrew安装
brew install --cask visual-studio-code

# 安装常用扩展
code --install-extension vscjava.vscode-java-pack
code --install-extension vscjava.vscode-maven
code --install-extension redhat.java
code --install-extension dbaeumer.vscode-eslint

IntelliJ IDEA

# 使用Homebrew安装
brew install --cask intellij-idea-ce  # 社区版
# 或
# brew install --cask intellij-idea  # 旗舰版

其他必备开发工具

Git安装与配置

macOS通常预装了Git，但可能不是最新版本：

# 使用Homebrew安装/更新Git
brew install git

# 配置Git
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"
git config --global init.defaultBranch main

# 生成SSH密钥
ssh-keygen -t ed25519 -C "your.email@example.com"

Docker安装

# 使用Homebrew安装Docker Desktop
brew install --cask docker

# 启动Docker Desktop（会自动打开应用程序）
open /Applications/Docker.app

数据库环境

MySQL

# 安装MySQL
brew install mysql

# 启动MySQL服务
brew services start mysql

# 安全配置
mysql_secure_installation

PostgreSQL

# 安装PostgreSQL
brew install postgresql

# 启动服务
brew services start postgresql

# 创建数据库
createdb my_database

MongoDB

# 安装MongoDB
brew tap mongodb/brew
brew install mongodb-community

# 启动服务
brew services start mongodb-community

Redis

# 安装Redis
brew install redis

# 启动服务
brew services start redis

macOS特有开发工具

iTerm2 - 增强终端

# 安装iTerm2
brew install --cask iterm2

推荐配置：

  • 安装Oh My Zsh: sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"
  • 安装Powerline字体: git clone https://github.com/powerline/fonts.git && cd fonts && ./install.sh

Alfred - 生产力工具

brew install --cask alfred

Homebrew Cask快速安装其他工具

# 开发工具
brew install --cask postman         # API测试工具
brew install --cask dbeaver-community  # 数据库管理工具
brew install --cask sourcetree      # Git GUI客户端
brew install --cask figma           # UI设计工具
brew install --cask rectangle       # 窗口管理
brew install --cask cheatsheet      # 显示快捷键

多版本管理工具

SDKMAN - 管理Java相关工具

# 安装SDKMAN
curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"

# 列出可用Java版本
sdk list java

# 安装指定版本
sdk install java 17.0.6-tem

# 切换版本
sdk use java 17.0.6-tem

# 同样可以管理Maven、Gradle等
sdk install maven
sdk install gradle

环境变量管理

macOS使用多个文件管理环境变量：

  • ~/.zshrc：对于使用zsh（macOS Catalina及以上版本默认）
  • ~/.bash_profile或~/.bashrc：对于使用bash的情况

创建开发环境配置脚本

# 创建脚本
nano ~/bin/dev-env.sh

添加以下内容：

#!/bin/bash

# 显示所有开发环境信息
echo "=== 开发环境信息 ==="
echo "操作系统: $(sw_vers -productName) $(sw_vers -productVersion)"
echo "Java: $(java -version 2>&1 | head -n 1)"
echo "Maven: $(mvn -version | head -n 1)"
echo "Node: $(node -v)"
echo "npm: $(npm -v)"
echo "Git: $(git --version)"
echo "====================="

# 快速切换Java版本
function use_java() {
  export JAVA_HOME=$(/usr/libexec/java_home -v $1)
  echo "已切换到Java $1: $JAVA_HOME"
  java -version
}

# 使用方法: use_java 17

使环境配置生效：

chmod +x ~/bin/dev-env.sh
echo "source ~/bin/dev-env.sh" >> ~/.zshrc
source ~/.zshrc

常见问题与解决方案

Java相关问题

  1. 多个JDK版本管理

    • 使用SDKMAN或手动配置JAVA_HOME
    • 使用/usr/libexec/java_home -V查看所有已安装的JDK

  2. 查看当前使用的Java版本

    java -version
echo $JAVA_HOME
/usr/libexec/java_home

Homebrew相关问题

  1. Homebrew更新慢

    • 使用国内镜像：
    # 替换brew.git
git -C "$(brew --repo)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git

# 替换homebrew-core.git
git -C "$(brew --repo homebrew/core)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git

  2. Homebrew权限问题

    sudo chown -R $(whoami) $(brew --prefix)/*

Node.js问题

  1. 全局包安装权限问题
    # 配置npm全局安装目录到用户目录
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'

# 添加到PATH
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

优化开发体验

修改系统配置

# 显示所有文件扩展名
defaults write NSGlobalDomain AppleShowAllExtensions -bool true

# 禁用.DS_Store文件创建（网络驱动器）
defaults write com.apple.desktopservices DSDontWriteNetworkStores -bool true

# 启用开发模式
sudo DevToolsSecurity -enable

实用命令行工具

# jq - JSON处理工具
brew install jq

# wget - 下载工具
brew install wget

# htop - 进程管理器
brew install htop

# tldr - 命令示例
brew install tldr

参考资源

如有任何问题或建议，欢迎联系我交流讨论。