不使用--legacy-peer-deps/--force解决npm对等依赖冲突问题

1. 先定位冲突根源 #

• 运行 npm ls 或者指定报错里提到的冲突包名（比如@radix-ui/react-separator）执行 npm ls @radix-ui/react-separator，精准找出哪两个包的版本不兼容。
• 对比shadcn-ui的separator组件要求的依赖版本和你项目package.json里已安装的对应包版本，确认版本差异点。

2. 手动对齐依赖版本 #

• 如果是radix-ui版本不匹配，先卸载冲突的包：npm uninstall @radix-ui/react-separator
• 安装shadcn-ui要求的指定版本（比如它要求^1.0.3）：npm install @radix-ui/react-separator@^1.0.3
• 再重新运行 npx shadcn-ui@latest add separator

3. 用npm overrides强制统一版本 #

如果有多个依赖包要求不同版本导致冲突，在package.json里添加overrides字段强制统一到兼容版本：

{
  "overrides": {
    "@radix-ui/react-separator": "^1.0.3" // 替换为shadcn要求的版本号
  }
}

执行 npm install 重新安装依赖后，再运行shadcn的安装命令。

4. 最坏情况：手动安装组件 #

• 先安装所需的radix基础组件：npm install @radix-ui/react-separator
• 在你的项目里创建组件文件（比如components/ui/separator.tsx），复制shadcn-ui提供的separator组件代码到该文件中
• 根据你的项目结构调整导入路径（比如适配tailwind配置、组件导出方式）

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