📌 前言：为什么要这么折腾？
很多教程告诉你 curl | bash一把梭，但在国内网络环境 + Mac 新架构（M 系列芯片）下，这往往会遇到：
- ❌
raw.githubusercontent.com连不上 - ❌
nvm ls-remote无输出或输出 HTML - ❌ Node 装好了但 npm 全局包冲突
- ❌ zsh 报
insecure directories
本文基于 nvm 官方 GitHub README 与 install.sh 脚本逻辑 ，结合实战踩坑，给出一套 100% 可复现的安装方案。
一、核心原理（Dan Koe 系统思维）
在开始之前，理解这三个东西的关系至关重要：
| 组件 | 作用 | 官方推荐 |
|---|---|---|
| nvm | Node 版本管理器 | 官方推荐 |
| Node.js | JavaScript 运行时 | 通过 nvm 安装 |
| npm | 包管理器 | 随 Node 自带 |
核心原则：
- 不要直接安装 Node：避免系统级权限污染。
- 不要使用
sudo npm install：nvm 的精髓在于用户级隔离。 - 国内必须配置镜像：这是成功的关键。
二、Step 1：安装 nvm（从 0 开始）
✅ 前置检查
确保你有 git：
git --version如果没有，先安装 Xcode Command Line Tools：
xcode-select --install✅ 坑 1：官方脚本下载失败（国内高频）
❌ 不推荐（国内常失败）：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash✅ 正确方案：Git Clone（官方支持）
根据 install.sh逻辑，如果 curl失败，应使用 git安装：
git clone https://github.com/nvm-sh/nvm.git ~/.nvm
cd ~/.nvm
git checkout v0.40.4✅ 坑 2：脚本未自动写入 Shell（手动补全 nvm 初始化）
有时 install.sh会因为权限或网络问题 没有自动修改你的 Shell 配置文件。你需要手动补全。
-
打开你的 Shell 配置文件（Mac 默认是 zsh）：
open -e ~/.zshrc如果文件不存在：
touch ~/.zshrc -
添加以下内容（这是 nvm 的灵魂）：
export NVM_DIR="$HOME/.nvm" [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion" # This loads nvm bash_completion -
使配置生效：
source ~/.zshrc
✅ 验证 nvm 是否安装成功
command -v nvm✅ 正确输出：nvm
三、Step 2：配置国内镜像（解决 Node 版本查询 & 下载）
✅ 坑 3：nvm ls-remote无输出或输出 HTML
如果你执行 nvm ls-remote --lts出现 空白，或者出现：
This is not the package you are looking for
这是因为 GitHub / Node 官方源被拦截。
根据 README 中的 Environment variables 说明，我们需要设置镜像。
✅ 解决方案：配置 Node 国内镜像
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node永久生效（强烈推荐）：
echo 'export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node' >> ~/.zshrc
source ~/.zshrc✅ 配置 npm 国内镜像（加速依赖下载）
npm config set registry https://registry.npmmirror.com四、Step 3：使用 nvm 安装 & 验证 Node
✅ 安装 Node LTS（推荐）
nvm install --lts✅ 设置默认版本
nvm alias default lts/*
nvm use --lts✅ 完整验证
node -v # 应显示 v20.x.x 或更高
npm -v
nvm ls # 应显示当前使用的 Node 版本✅ 正确状态 ：node的路径应包含 .nvm，例如：
/Users/你的用户名/.nvm/versions/node/v20.18.0/bin/node五、Step 4：创建并运行 Vue 项目
✅ 创建 Vue 项目
npm create vite@latest my-vue-app -- --template vue
cd my-vue-app✅ 安装依赖并启动
rm -rf node_modules package-lock.json # 养成好习惯，确保干净安装
npm install
npm run dev✅ 浏览器访问 http://localhost:5173，看到 Vue 欢迎页即成功。
六、常见"坑"单独标注（排雷区）
⚠️ 坑 4：.npmrc导致 nvm 冲突
现象：
Your user's .npmrc file has a `globalconfig` and/or a `prefix` setting, which are incompatible with nvm.解决：
nvm use --delete-prefix v24.16.0 --silent或者手动删除 ~/.npmrc中的 prefix和 globalconfig配置。
⚠️ 坑 5：zsh insecure directories
现象：
zsh compinit: insecure directories原因 ：Homebrew 或手动修改导致 /usr/local/share/zsh权限过松。
解决：
sudo chown -R $(whoami):staff /usr/local/share/zsh
chmod -R u+rwx,go-w,go+rX /usr/local/share/zsh⚠️ 坑 6：Node 版本号不存在
现象：
Version '20.19.0' not found原因 ：Vite 提示的是 major.minor 要求，并非完整版本号。
解决 ：使用 nvm install --lts或查询 nvm ls-remote找真实存在的 patch 版本（如 20.18.0）。
七、总结
- 安装 nvm ：放弃
curl | bash，使用git clone更稳定。 - 初始化 nvm ：若脚本未自动写入，务必手动补全
~/.zshrc。 - 国内镜像 ：必须配置
NVM_NODEJS_ORG_MIRROR和 npm registry。 - Node 管理 ：始终使用
nvm install和nvm use。
按照这套流程，你的 Mac 将拥有一个 干净、隔离、可随时切换版本 的 Node 开发环境，足以应对 Vue等各种复杂实战场景。
如果这篇文章解决了你的环境难题，请不要吝啬你的 👍 (点赞) 和 ⭐ (收藏)！
有任何环境搭建的疑问，欢迎在评论区留言交流。