安装使用semantic-ui的React旧项目时npm报错primordials未定义

• primordials is not defined 报错是版本不兼容导致的。semantic-ui 2.x全版本内置依赖gulp 3.x，而gulp 3.x依赖的旧版graceful-fs调用了Node 12+版本已经移除的内部API primordials，你当前使用的Node v16属于跨大版本不兼容范围，直接触发报错。

报错原文参考：

npm ERR! ReferenceError: primordials is not defined
npm ERR! at fs.js:47:5

• 实际安装版本与package.json声明不一致，是因为声明的版本号默认带^前缀（即^2.2.13），npm会自动安装2.x大版本下的最新兼容版，加上npm 7的依赖解析规则，哪怕加了--legacy-peer-deps也会优先拉取更高的兼容版本。

以下方案按落地成本从低到高排序，按需选择：

方案1：降级Node版本（最稳妥，无需修改项目配置） #

semantic-ui 2.2.13的适配最高Node版本为10.x LTS，通过版本管理工具切换Node版本即可解决：

1. Windows系统安装nvm-windows，类Unix系统安装nvm
2. 执行命令安装适配版本：nvm install 10.24.1
3. 切换到对应版本：nvm use 10.24.1
4. 删除项目根目录下的node_modules文件夹和package-lock.json文件
5. 重新执行安装命令：npm install

方案2：保留Node 16，锁定版本+兼容处理 #

如果不想降级Node，可通过npm overrides强制锁定版本并替换兼容依赖：

1. 修改package.json中semantic-ui的声明，去掉版本号前的^前缀，改为固定版本：

"dependencies": {
  "semantic-ui": "2.2.13"
}

2. 在package.json中新增overrides配置（npm 7+原生支持），强制替换gulp为兼容高版本Node的4.x版本：

"overrides": {
  "semantic-ui": "2.2.13",
  "semantic-ui/gulp": "^4.0.0"
}

3. 删除node_modules和package-lock.json，执行npm install --legacy-peer-deps重新安装即可。

方案3：替换依赖为无编译版本（适合无需自定义语义化UI主题的项目） #

如果你的项目不需要自定义semantic-ui主题，可直接替换为预编译的CSS版本，完全跳过gulp安装步骤：

1. 删掉package.json中的semantic-ui依赖
2. 新增预编译版本依赖："semantic-ui-css": "2.2.13"
3. 删除node_modules和package-lock.json，重新执行安装命令即可，无需额外配置。

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