React+Mantine项目安装@modulz/radix-icons遇依赖冲突如何解决？

问题根源 #

你安装的@modulz/radix-icons@4.0.0仅支持React 16.x或17.x，但你的项目使用的是React 18.2.0，peer依赖版本不匹配导致冲突。

解决方案 #

1. 安装兼容React18的官方替代包（推荐）

@modulz/radix-icons已被官方迁移至@radix-ui/icons，该包完全支持React18，且是当前持续维护的版本：

npm install @radix-ui/icons

安装后替换代码中的导入路径即可，比如将import { ... } from '@modulz/radix-icons'改为import { ... } from '@radix-ui/icons'。

2. 安装支持React18的@modulz/radix-icons版本

如果坚持使用原包名，可安装5.0.0及以上版本（从该版本开始支持React18）：

npm install @modulz/radix-icons@^5.0.0

3. 临时绕过peer依赖检查（不推荐）

若需快速临时解决，可使用npm参数忽略peer依赖冲突：

• 推荐使用--legacy-peer-deps（不会修改依赖树，仅跳过peer依赖校验）：

  npm install @modulz/radix-icons --legacy-peer-deps
  

• 或使用--force（强制安装，可能导致依赖树异常，不建议长期使用）：

  npm install @modulz/radix-icons --force
  

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