React项目npm安装包报错：react-currency-format与React版本冲突

问题背景 #

开发React项目时，安装npm包频繁报错，之前通过npm i package_name -f强制安装虽能成功，但希望明确问题根源并找到正确修复方式，已尝试npm audit fix --force无效。

报错信息 #

npm ERR! code ERESOLVE
npm ERR! ERESOLVE could not resolve
npm ERR!
npm ERR! While resolving: react-currency-format@1.1.0     
npm ERR! Found: react@18.2.0
npm ERR! node_modules/react
npm ERR!   peer react@">=16.8.0" from @emotion/react@11.10.0
npm ERR!   node_modules/@emotion/react
npm ERR!     peer @emotion/react@"^11.0.0-rc.0" from @emotion/styled@11.10.0
npm ERR!     node_modules/@emotion/styled
npm ERR!       peerOptional @emotion/styled@"^11.3.0" from
 @mui/material@5.10.2
npm ERR!       node_modules/@mui/material
npm ERR!         peer @mui/material@"^5.0.0" from @mui/icons-material@5.10.2
npm ERR!         node_modules/@mui/icons-material
npm ERR!         1 more (the root project)
npm ERR!       3 more (@mui/styled-engine, @mui/system, the root project)
npm ERR!     peerOptional @emotion/react@"^11.5.0" from @mui/material@5.10.2
npm ERR!     node_modules/@mui/material
npm ERR!       peer @mui/material@"^5.0.0" from @mui/icons-material@5.10.2
npm ERR!       node_modules/@mui/icons-material
npm ERR!         @mui/icons-material@"^5.10.2" from the root project
npm ERR!       1 more (the root project)
npm ERR!     3 more (@mui/styled-engine, @mui/system, the root project)
npm ERR!   peer react@">=16.8.0" from @emotion/styled@11.10.0
npm ERR!   node_modules/@emotion/styled
npm ERR!     peerOptional @emotion/styled@"^11.3.0" from @mui/material@5.10.2
npm ERR!     node_modules/@mui/material
npm ERR!       peer @mui/material@"^5.0.0" from @mui/icons-material@5.10.2
npm ERR!       node_modules/@mui/icons-material
npm ERR!         @mui/icons-material@"^5.10.2" from the root project
npm ERR!       1 more (the root project)
npm ERR!     peerOptional @emotion/styled@"^11.3.0" from @mui/styled-engine@5.10.2
npm ERR!     node_modules/@mui/styled-engine
npm ERR!       @mui/styled-engine@"^5.10.2" from @mui/system@5.10.2
npm ERR!       node_modules/@mui/system
npm ERR!         @mui/system@"^5.10.2" from @mui/material@5.10.2
npm ERR!         node_modules/@mui/material
npm ERR!     2 more (@mui/system, the root project)       
npm ERR!   15 more (@mui/base, @mui/icons-material, @mui/material, ...)
npm ERR!
npm ERR! Could not resolve dependency:
npm ERR! peer react@"^0.14 || ^15.0.0-rc || ^15.0.0 || ^16.0.0-rc || ^16.0.0 || ^17.0.0" from react-currency-format@1.1.0
npm ERR! node_modules/react-currency-format
npm ERR!   react-currency-format@"^1.1.0" from the root project
npm ERR! 
npm ERR! Conflicting peer dependency: react@17.0.2        
npm ERR! node_modules/react
npm ERR!   peer react@"^0.14 || ^15.0.0-rc || ^15.0.0 || ^16.0.0-rc || ^16.0.0 || ^17.0.0" from react-currency-format@1.1.0
npm ERR!   node_modules/react-currency-format
npm ERR!     react-currency-format@"^1.1.0" from the root project
npm ERR!
npm ERR! Fix the upstream dependency conflict, or retry   
npm ERR! this command with --force, or --legacy-peer-deps 
npm ERR! to accept an incorrect (and potentially broken) dependency resolution.
npm ERR!
npm ERR! See C:\Users\naveen\AppData\Local\npm-cache\eresolve-report.txt for a full report.

核心问题根源 #

react-currency-format@1.1.0的peer依赖明确要求React版本为^0.14 || ^15.0.0-rc || ^15.0.0 || ^16.0.0-rc || ^16.0.0 || ^17.0.0，但当前项目使用的是React@18.2.0，两者版本不匹配，导致npm的依赖解析器无法完成依赖树构建，抛出ERESOLVE错误。

正确修复方法 #

1. 升级react-currency-format到兼容React 18的版本 #

检查react-currency-format的最新版本，通常较新的版本会适配React 18。执行以下命令安装最新兼容版本：

npm install react-currency-format@latest

如果已知具体兼容版本（比如v2.x及以上），也可以指定版本安装：

npm install react-currency-format@^2.0.0

2. 使用--legacy-peer-deps参数安装依赖 #

如果暂时无法升级react-currency-format，可以使用--legacy-peer-deps参数让npm采用v6版本的依赖解析逻辑，忽略peer依赖冲突（此方式比--force更安全，不会强制覆盖已有依赖）：

npm install --legacy-peer-deps

3. 降级React到17.x版本 #

如果项目不需要React 18的新特性，可以降级React及ReactDOM到17.x版本，满足react-currency-format@1.1.0的peer依赖要求：

npm install react@^17.0.2 react-dom@^17.0.2

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