在 macOS 上搭建 Node.js 环境需安装运行时并配置版本管理：一、用 Homebrew 安装 Node.js；二、用 nvm 管理多版本；三、通过官方 pkg 手动安装；四、配置 npm 全局路径避免权限问题。
如果您在 macOS 系统上需要运行 JavaScript 代码或开发基于 Node.js 的项目，必须先安装 Node.js 运行时环境并配置可用的版本管理机制。以下是完成 Node.js 环境搭建与多版本管理的具体步骤：
一、使用 Homebrew 安装 Node.js
Homebrew 是 macOS 上最常用的包管理器，通过它可一键安装稳定版 Node.js 及配套 npm 工具。该方式默认将 Node.js 安装至 /opt/homebrew/bin（Apple Silicon）或 /usr/local/bin（Intel），并自动配置 PATH。
1、打开“终端”应用。
2、执行命令安装 Homebrew（若尚未安装）：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"。
3、运行 brew update 更新软件包索引。
4、执行 brew install node 安装最新 LTS 版本的 Node.js。
5、验证安装：node -v && npm -v，输出应显示版本号。
二、使用 Node Version Manager（nvm）管理多个 Node.js 版本
nvm 允许用户在同一台 Mac 上安装、切换不同版本的 Node.js，适用于需兼容多种 Node 版本的开发场景。它不依赖系统路径，所有版本独立存放于用户目录下。
1、在终端中运行命令下载并安装 nvm：curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash。
2、关闭并重新打开终端，或执行 source ~/.zshrc（macOS Catalina 及更新版本默认使用 zsh）。
3、检查 nvm 是否生效：command -v nvm，应返回 nvm。
4、列出所有可安装的 Node.js 版本：nvm list-remote。
5、安装指定版本（例如 v18.19.0）：nvm install 18.19.0。
6、设置默认使用的版本：nvm alias default 18.19.0。
7、切换当前 shell 中的 Node.js 版本：nvm use 18.19.0。
三、通过官方 pkg 安装包手动安装 Node.js
此方法适用于无法使用命令行工具或需严格控制安装路径的用户。安装包会将 Node.js 写入 /usr/local/bin，并注册为系统级命令，但不支持多版本共存。
1、访问 Node.js 官网 https://nodejs.org，点击“Downloads”按钮，选择 macOS Installer (.pkg) 文件（推荐 LTS 版本）。
2、双击下载完成的 .pkg 文件，按向导提示完成安装（需输入管理员密码）。
3、安装完成后，在终端中执行 which node，确认路径为 /usr/local/bin/node。
4、运行 node -v 和 npm -v 验证是否成功。
四、验证全局 npm 包路径与权限配置
npm 默认将全局包安装到 /usr/local/lib/node_modules，但 macOS 系统升级后可能因 SIP 或权限变更导致 EACCES 错误。需确保 npm 使用用户专属目录以避免 sudo 操作。
1、创建 npm 全局安装目录：mkdir ~/.npm-global。
2、配置 npm 使用该目录：npm config set prefix '~/.npm-global'。
3、编辑 ~/.zshrc 文件：echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc。
4、重载配置：source ~/.zshrc。
5、测试安装全局包（如 http-server）：npm install -g http-server，随后执行 http-server --version 确认生效。
