macOS 开发环境安装指南
本文档记录了 macOS 开发环境的安装步骤，包括 NVM、Node.js、JDK 17 和 Maven 的配置。
目录结构
/Users/****/devApp/
├── nvm/ # NVM 安装目录
├── java/ # JDK 安装目录
├── maven/ # Maven 安装目录
└── anaconda/ # Anaconda 安装目录
一、安装 NVM（Node Version Manager）
1. 创建安装目录
mkdir -p /Users/****/devApp/nvm
2. 下载 NVM 核心文件
export NVM_DIR="/Users/****/devApp/nvm"
curl -s -o "$NVM_DIR/nvm.sh" https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/nvm.sh
curl -s -o "$NVM_DIR/nvm-exec" https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/nvm-exec
curl -s -o "$NVM_DIR/bash_completion" https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/bash_completion
chmod +x "$NVM_DIR/nvm-exec"
3. 配置环境变量
编辑 ~/.zshrc，添加以下内容：
export NVM_DIR="/Users/****/devApp/nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \\. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \\. "$NVM_DIR/bash_completion"
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
export NVM_IOJS_ORG_MIRROR=https://npmmirror.com/mirrors/iojs
4. 验证安装
source ~/.zshrc
nvm –version
5. 安装 Node.js
nvm install –lts # 安装 LTS 版本
nvm install 18 # 安装指定版本
nvm alias default 18 # 设置默认版本
node –version
npm –version
二、配置 npm 镜像加速
配置阿里镜像
创建或编辑 ~/.npmrc：
echo "registry=https://registry.npmmirror.com/" > ~/.npmrc
验证配置
npm config get registry
npm view react version
三、安装 JDK 17
1. 下载安装包
下载地址：https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html
选择对应系统版本：
- Intel 芯片：jdk-17.0.12_macos-x64_bin.tar.gz
- Apple Silicon 芯片：jdk-17.0.12_macos-aarch64_bin.tar.gz
2. 解压到安装目录
mkdir -p /Users/****/devApp/java
tar -xzf /Users/****/Downloads/jdk-17.0.12_macos-x64_bin.tar.gz -C /Users/****/devApp/java
3. 配置环境变量
编辑 ~/.zshrc，添加以下内容：
export JAVA_HOME="/Users/****/devApp/java/jdk-17.0.12.jdk/Contents/Home"
export PATH="$JAVA_HOME/bin:$PATH"
4. 验证安装
source ~/.zshrc
java -version
javac -version
echo $JAVA_HOME
四、安装 Maven
1. 下载安装包
下载地址：https://maven.apache.org/download.cgi
选择 apache-maven-3.9.11-bin.tar.gz
2. 解压到安装目录
mkdir -p /Users/****/devApp/maven
tar -xzf /Users/****/Downloads/apache-maven-3.9.11-bin.tar.gz -C /Users/****/devApp/maven
3. 配置环境变量
编辑 ~/.zshrc，添加以下内容：
export MAVEN_HOME="/Users/****/devApp/maven/apache-maven-3.9.11"
export PATH="$MAVEN_HOME/bin:$PATH"
4. 验证安装
source ~/.zshrc
mvn -version
五、安装 Anaconda
1. 下载安装包
下载地址：https://www.anaconda.com/products/distribution#download-section
选择 macOS x86_64 版本的 .sh 安装脚本。
2. 执行安装脚本
chmod +x /Users/****/Downloads/Anaconda3-2024.06-1-MacOSX-x86_64.sh
/Users/****/Downloads/Anaconda3-2024.06-1-MacOSX-x86_64.sh -b -p /Users/****/devApp/anaconda
参数说明：
- -b：静默安装模式，不显示交互式界面
- -p：指定安装路径
3. 配置环境变量
编辑 ~/.zshrc，添加以下内容：
export PATH="/Users/****/devApp/anaconda/bin:$PATH"
4. 配置 conda 镜像加速
创建或编辑 ~/.condarc：
channels:
– defaults
show_channel_urls: true
default_channels:
– https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main
– https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/r
– https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/msys2
custom_channels:
conda-forge: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
msys2: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
bioconda: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
pytorch: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
envs_dirs:
– /Users/****/devApp/anaconda/envs
5. 验证安装
source ~/.zshrc
conda –version
python –version
六、完整 .zshrc 配置
export NVM_DIR="/Users/****/devApp/nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \\. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \\. "$NVM_DIR/bash_completion"
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
export NVM_IOJS_ORG_MIRROR=https://npmmirror.com/mirrors/iojs
export JAVA_HOME="/Users/****/devApp/java/jdk-17.0.12.jdk/Contents/Home"
export PATH="$JAVA_HOME/bin:$PATH"
export MAVEN_HOME="/Users/****/devApp/maven/apache-maven-3.9.11"
export PATH="$MAVEN_HOME/bin:$PATH"
export PATH="/Users/****/devApp/anaconda/bin:$PATH"
七、验证所有工具
source ~/.zshrc
echo "=== NVM ==="
nvm –version
echo ""
echo "=== Node.js ==="
node –version
npm –version
echo ""
echo "=== JDK ==="
java -version
echo ""
echo "=== Maven ==="
mvn -version
echo ""
echo "=== Anaconda ==="
conda –version
python –version
八、常见问题
1. npm 权限问题
如果遇到 EPERM 错误，可能是缓存目录权限问题：
sudo chown -R ****:staff /Users/****/.npm
2. nvm 命令找不到
确保已执行 source ~/.zshrc，或重启终端。
3. JDK 版本不匹配
确保下载的是 macOS 版本（macos-x64 或 macos-aarch64），而非 Linux 版本（linux-x64）。
4. Maven 依赖下载慢
在 Maven 的 settings.xml 中配置阿里镜像：
<mirrors>
<mirror>
<id>aliyunmaven</id>
<mirrorOf>central</mirrorOf>
<url>https://maven.aliyun.com/repository/public</url>
</mirror>
</mirrors>
settings.xml 路径：/Users/****/devApp/maven/apache-maven-3.9.11/conf/settings.xml
5. conda 命令找不到
确保已执行 source ~/.zshrc，或重启终端。
6. conda activate 命令不可用
如果 conda activate 命令不可用，需要执行 conda init zsh（需要管理员权限）：
conda init zsh
执行后重启终端即可使用 conda activate/deactivate 命令。
7. conda 安装包慢
确保已配置清华镜像源，参考本文档第五部分的 .condarc 配置。
