laravel 12虽不依赖node.js运行，但因vite构建需node≥18.18.0且多版本共存，必须用nvm管理版本并重定向npm全局路径，否则编译必败。
Laravel 12 本身不依赖 Node.js 运行，但绝大多数 Laravel 项目需要 Node.js 来编译前端资源（如 Vite、Tailwind CSS、Sass、JavaScript 模块），所以配置 Node.js 不是可选项，而是实际开发的刚性前提。
为什么不能只装官网.pkg就完事
官网下载的 .pkg 安装包虽能快速让 node -v 和 npm -v 工作，但它把 Node.js 固定在 /usr/local/bin，无法切换版本。而 Laravel 12 默认使用 Vite 构建，Vite 对 Node.js 版本有明确要求（推荐 ≥ v18.18.0，不兼容 v21+ 的某些实验性 API），同时你可能还要维护旧 Laravel 9/10 项目（依赖 Node 16）。硬编码单版本极易触发 ERR_OSSL_EVP_UNSUPPORTED 或 Cannot use import statement outside a module 等构建失败。
- 官网安装后
which node返回/usr/local/bin/node，全局唯一，无法隔离项目环境 - 一旦升级系统或重装 macOS，
/usr/local/bin下的二进制可能被覆盖或权限重置 - npm 全局模块（如
vite、laravel-vite-plugin）容易因权限问题写入失败，报EPERM: operation not permitted
nvm 是最稳妥的选择（尤其对 Laravel 多版本共存）
nvm 把每个 Node.js 版本装在用户目录下（~/.nvm/versions/node/），完全绕过系统路径和权限冲突，且支持项目级自动切换——这正是 Laravel 12 + Vite 工作流真正需要的。
- 安装命令（zsh 用户）：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash，然后source ~/.zshrc - 安装并启用 LTS（适配 Laravel 12）：
nvm install --lts→nvm use --lts→nvm alias default lts/* - 在 Laravel 项目根目录创建
.nvmrc文件，内容为20.12.1（Laravel 12 推荐的稳定 Node 版本），之后进入该目录执行nvm use即可自动切换 - 务必设置国内镜像源，否则
nvm install极慢：nvm node_mirror https://npmmirror.com/mirrors/node/
npm 全局路径必须重定向（否则 vite build 会失败）
Laravel 12 的 package.json 中 "build": "vite build" 依赖全局 vite 命令。若 npm 全局模块默认装在 /usr/local/lib/node_modules，macOS 可能拒绝写入（尤其 Apple Silicon + System Integrity Protection）。直接 sudo npm install -g vite 是危险操作，会导致后续 npm run build 权限混乱。
- 创建独立全局目录：
mkdir ~/.npm-global - 配置 npm 使用它：
npm config set prefix '~/.npm-global' - 将该路径加入
$PATH：在~/.zshrc末尾添加export PATH=~/.npm-global/bin:$PATH，再source ~/.zshrc - 验证：
npm install -g vite后，which vite应返回~/.npm-global/bin/vite
验证 Laravel 12 资源编译是否真正常
装完 Node.js 不代表前端流程通了。很多开发者卡在 npm run build 报错却以为是 Node 版本问题，其实常是 npm 配置或依赖树损坏。
- 进入 Laravel 项目后，先运行：
nvm use（确保匹配.nvmrc）、npm ci（比npm install更干净，强制按package-lock.json安装） - 检查
resources/js/app.js是否含import './bootstrap';—— Laravel 12 默认用 ESM，若误删此行，vite build会静默生成空build/assets/app.*.js - 运行
npm run dev，观察终端输出是否包含vite v5.x.x和ready in XXX ms，而非卡在building...或报Failed to resolve entry for package "laravel-vite-plugin" - 如果仍失败，临时删掉
node_modules和package-lock.json，再nvm use && npm ci—— 这比反复重装 Node.js 更有效
真正麻烦的不是装 Node.js，而是让 npm 的全局路径、本地依赖、Vite 插件三者对齐。每一步都绕不开 nvm 的版本隔离和 npm config set prefix 的路径重定向，跳过任一环节，后面都会在 npm run build 时突然崩掉。
