使用Node.js 14.15.0执行Gulp Build时出现找不到node:path模块错误

错误原因 #

node:path这种带node:前缀的内置模块导入语法是Node.js 16.0.0及以上版本才支持的特性，你当前使用的Node.js 14.15.0不兼容该语法，导致依赖的@microsoft/rush-lib模块加载失败。

具体解决步骤 #

方案1：切换到兼容的Node.js版本（优先推荐） #

如果项目没有强制要求Node.js 14，直接切换到你已安装的18.19.0版本：

1. 执行命令切换版本：

   nvm use 18.19.0
   

2. 删除项目目录下的node_modules文件夹和package-lock.json文件
3. 重新安装依赖：

   npm install
   

4. 再次运行构建命令：

   gulp build
   

方案2：降级依赖以适配Node.js 14（仅当项目必须用Node14时） #

如果项目明确要求使用Node.js 14，需要将依赖降级到兼容Node14的版本：

1. 打开项目的package.json文件，找到以下依赖项：
   • @microsoft/rush-lib
   • @microsoft/spfx-heft-plugins
   • @microsoft/sp-build-core-tasks
   • @microsoft/sp-build-web
2. 查找这些依赖支持Node.js 14的历史版本，修改package.json中的版本号
3. 删除node_modules和package-lock.json
4. 重新安装依赖并执行构建：

   npm install
   gulp build
   

方案3：临时hack兼容（不推荐长期使用） #

紧急情况下可以临时模拟node:path模块：

1. 在项目的node_modules目录下创建node:path文件夹
2. 在该文件夹内创建index.js文件，内容为：

   module.exports = require('path');
   

3. 再次运行gulp build

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