Node.js v22运行npm-check报primordials未定义错误求助

这个错误的核心原因是旧版graceful-fs（v3.x）与Node.js 12+不兼容——Node.js 12及以后版本移除了内部的primordials变量，而npm-check的依赖链中存在的graceful-fs@3.0.12仍在调用这个已被移除的API，同时package-lock.json中多个graceful-fs实例也会导致版本冲突。

解决方案 #

1. 升级npm-check到兼容版本 #

旧版npm-check依赖的包存在兼容性问题，直接升级到最新版：

• 卸载全局npm-check：

  npm uninstall -g npm-check
  

• 安装最新全局版：

  npm install -g npm-check
  

如果全局安装仍有问题，改为本地安装并通过npx运行：

npm install npm-check --save-dev
npx npm-check

2. 强制统一依赖树中graceful-fs的版本 #

利用npm的resolutions字段强制所有依赖使用兼容Node.js 12+的graceful-fs v4.x版本：
在项目根目录的package.json中添加以下内容：

"resolutions": {
  "graceful-fs": "^4.2.11"
}

然后执行重新安装：

npm install

执行后可以用以下命令验证所有graceful-fs实例已统一：

npm ls graceful-fs

3. 排查并处理旧版gulp依赖 #

旧版gulp（v3.x）是graceful-fs v3.x的常见依赖来源：

• 检查项目是否安装了gulp：

  npm ls gulp
  

• 如果不需要gulp，直接卸载相关依赖：

  npm uninstall gulp gulp-cli --save-dev
  

• 如果需要gulp，升级到兼容的v4.x版本：

  npm uninstall gulp gulp-cli
  npm install gulp@latest gulp-cli@latest --save-dev
  

4. 清理缓存并重新安装依赖 #

若上述方法无效，清理npm缓存并重新构建依赖：

# 清理npm缓存
npm cache clean --force

# 删除现有依赖和锁文件
rm -rf node_modules package-lock.json  # Windows系统用 rmdir /s /q node_modules && del package-lock.json

# 重新安装依赖
npm install

内容的提问来源于stack exchange，提问作者sifar