Node.js 故障排除

找不到特定版本的node/npm/pnpm/yarn等命令

如果出现类似下面的错误

Warning: Specified Node.js version '22' for 'node' not found.
If this is not your intention, please delete the 'NODE_VERSION' configuration
from the '.servbay.config' file in the current directory.

这是因为对应版本的 Node.js 在 ServBay 中没有安装，或者用户希望使用nvm自带的 Node.js 版本，但是因为一些配置上的原因导致无法找到nvm或者homebrew安装的 Node.js。

提示

安装 ServBay 后，node 命令的寻找优先级为：ServBay->nvm->homebrew

原因： 安装 ServBay 后，ServBay 的 Script Alias 会自动优先使用 ServBay 所安装的 Node.js。在某个版本的 Node.js 找不到的时候，会自动回落至nvm所安装的默认版本 Node.js。如果用户系统没有安装nvm，或者nvm配置不正确，那么会继续回落至homebrew所安装的 Node.js 版本。如果homebrew安装的 Node.js 也找不到，那么将会报告上述的错误。

解决方案：有部分用户安装了nvm，并且使用nvm安装了 Node.js，但还是报告上面的错误。这是因为用户的环境配置中缺失了NVM_BIN环境变量。在安装nvm时，nvm会自动配置这个变量。

用户只需要修复这个变量，就可以正确寻找到通过nvm所安装的 Node.js

使用 node-sass 等 npm 包时提示架构不支持

Apple Silicon（M1/M2/M3/M4）等 Arm64 芯片的用户，在使用一些老旧的 npm 包（比如 node-sass）时，会出现Unsupported architecture (arm64)的错误。这是因为苹果的 M 系列芯片是 Arm64 架构，node-sass 等包只支持x86_64的芯片架构。

ERROR: Module Error (from ./node_modules/sass-loader/dist/cjs.js): 
Node Sass does not yet support your current environment: OS X Unsupported architecture (arm64) with Node.js 14.x 
For more information on which environments are supported
please see:
https://github.com/sass/node-sass/releases/tag/v4.14.1

解决方案：

1、更换为更加现代的，支持 Arm64 的 npm 包（比如从node-sass更换为sass）

npm uninstall node-sass
npm install --save-dev sass

2、ServBay 提供了安装x86_64版本 Node.js 的选项，用户可以在 Node.js 安装界面选择安装x86_64架构的 Node.js（不建议）