求助：react-scroll-horizontal依赖解析失败及React版本冲突问题

问题原因 #

你的项目使用React 18.2.0，但react-scroll-horizontal@1.6.6的peer依赖要求React版本为^15.0.0 || ^16.0.0，npm v7+默认严格检查peer依赖，导致出现ERESOLVE依赖树解析错误；同时因为未成功安装该依赖，所以出现「Module not found: Can't resolve 'react-scroll-horizontal'」的错误。

解决方案 #

方案一：使用--legacy-peer-deps参数强制安装

这是最快的解决方式，绕过npm的严格peer依赖检查：

npm install react-scroll-horizontal --legacy-peer-deps

安装完成后，模块找不到的问题会自动解决。注意：这种方式可能引入潜在兼容性问题，建议安装后测试组件功能是否正常。

方案二：替换为支持React 18的水平滚动组件

由于react-scroll-horizontal已长期未更新、不支持React 18，更稳妥的方式是使用维护活跃的替代方案：

• 原生CSS实现：通过overflow-x: auto + display: flex即可快速实现水平滚动，无需额外依赖
• 使用react-scroll库：支持水平滚动配置，兼容React 18
• 选择其他现代React水平滚动组件（如react-horizontal-scrolling-menu等）

方案三：降级React版本（不推荐）

如果必须使用react-scroll-horizontal，可将React降级到16.x版本，但这会导致项目中其他依赖（如Next.js 13.4.7）出现兼容性问题，需同步调整相关依赖版本，操作成本较高，不建议采用。

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