切换NodeJS版本后npm start出现导出错误及依赖冲突求助

• 将NodeJS从v18.15.0切换至v16.20.2，删除并重装node_modules后执行npm start，出现42条类似错误：

  Can't import the named export (COMPONENT) from non EcmaScript module (only default export is available)

• 队友可正常运行项目，排除代码层面问题，锁定本地环境异常。
• 执行npm install必须加--force参数，否则会触发peer依赖冲突警告，关键日志如下：

  npm WARN using --force Recommended protections disabled.
  npm WARN ERESOLVE overriding peer dependency
  npm WARN While resolving: formik-material-ui@0.0.22
  npm WARN Found: react@"^17.0.2"
  npm WARN node_modules/react
  npm WARN   react@"^17.0.2" from the root project
  npm WARN   46 more (@material-ui/core, react-dom, @material-ui/icons, ...)
  npm WARN
  npm WARN Could not resolve dependency:
  npm WARN peer react@"^16.8.0" from formik-material-ui@0.0.22
  npm WARN node_modules/formik-material-ui
  npm WARN   formik-material-ui@"0.0.22" from the root project
  npm WARN
  npm WARN Conflicting peer dependency: react@16.14.0
  npm WARN node_modules/react
  npm WARN   peer react@"^16.8.0" from formik-material-ui@0.0.22
  npm WARN   node_modules/formik-material-ui
  npm WARN     formik-material-ui@"0.0.22" from the root project
  npm WARN ERESOLVE overriding peer dependency
  npm WARN While resolving: react-addons-css-transition-group@16.0.0-alpha.3
  npm WARN Found: react@"^17.0.2"
  npm WARN node_modules/react
  npm WARN   react@"^17.0.2" from the root project
  

  日志末尾重复提示：

  Could not resolve dependency:
  peer react@"^16.8.0" from formik-material-ui@0.0.22
  node_modules/formik-material-ui
    formik-material-ui@"0.0.22" from the root project
  
  Conflicting peer dependency: react@16.14.0
  node_modules/react
    peer react@"^16.8.0" from formik-material-ui@0.0.22
    node_modules/formik-material-ui
      formik-material-ui@"0.0.22" from the root project 
  

1. 统一npm版本 #

Node 16对应npm 8.x，先确认队友的npm版本：

npm -v

若版本不一致，安装对应版本：

npm install -g npm@<队友的npm版本号>

2. 彻底清理本地环境残留 #

# 删除node_modules
rm -rf node_modules
# 删除package-lock.json（用yarn则删yarn.lock）
rm package-lock.json
# 清理npm缓存
npm cache clean --force

3. 修复peer依赖冲突 #

方法A：使用legacy-peer-deps（推荐） #

替代--force，兼容旧版peer依赖同时保留基础保护：

npm install --legacy-peer-deps

方法B：升级冲突依赖 #

若项目允许，升级formik-material-ui到支持React 17的版本（当前0.0.22为老旧版本）：

npm install formik-material-ui@latest

注意：升级后需测试组件兼容性，避免API变更引发问题。

4. 解决ES模块导入错误 #

该问题多因Node版本切换后模块解析规则变化导致：

• 检查项目根目录package.json的type字段，若为CommonJS项目确保"type": "commonjs"，ES模块项目确保"type": "module"。
• 若清理依赖后仍报错，可临时修改报错组件的导入方式，将命名导入改为默认导入：

  // 原命名导入
  import { COMPONENT } from 'some-module';
  // 修改为默认导入
  import COMPONENT from 'some-module';
  

5. 确保环境完全一致 #

用nvm锁定Node版本：

# 安装nvm（未安装时执行）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 切换至指定版本
nvm use 16.20.2

确认Node、npm版本与队友完全一致后，重新安装依赖并启动项目。

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