安装旧项目时npm报错Cannot find module 'node:path'求解决方案

问题原因 #

报错Cannot find module 'node:path'说明当前运行的Node.js版本不支持node:前缀的内置模块导入（该语法从Node.js v16开始支持）。你虽然安装了v18.20.4，但系统实际调用的是更低版本的Node，或者Node/npm环境存在路径冲突、文件损坏。

解决方案步骤 #

• 检查当前Node版本
  执行以下命令确认实际运行的Node版本：

  node -v
  

  如果输出不是v18.20.4，说明路径优先级有问题，系统优先调用了旧版本。

• 修复Node环境冲突

  1. 卸载冲突版本：如果你同时用Homebrew和pkg安装了Node，先卸载Homebrew版本：

     brew uninstall --force node@18 node
     

  2. 重新安装pkg版本：删除现有Node残留后，重新运行node-v18.20.4.pkg完成安装，确保安装路径为/usr/local/bin/node。

• 重置npm
  如果npm本身文件损坏，执行以下命令重新安装对应版本的npm：

  curl -qL https://www.npmjs.com/install.sh | sh
  

• 清理缓存并重新安装依赖

  npm cache clean --force
  cd 你的项目目录
  npm install
  

.zshrc 正确配置示例 #

确保/usr/local/bin（pkg安装的Node所在路径）在PATH最前面，避免系统自带旧版本干扰。在~/.zshrc中添加或修改以下内容：

# 配置Node.js路径优先级
export PATH="/usr/local/bin:$PATH"

# 可选：如果使用nvm管理Node版本（推荐长期维护多版本）
# export NVM_DIR="$HOME/.nvm"
# [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
# [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"

修改后执行source ~/.zshrc使配置生效。

内容的提问来源于stack exchange，提问作者leon.s