React 19中npx shadcn-ui add calendar因react-day-picker依赖冲突失败

Bug描述 #

执行npx shadcn@latest add calendar命令时安装失败，核心原因是react-day-picker@8.10.1的peer依赖仅支持React 16.8.0/17.x/18.x版本，与当前项目的React 19存在兼容性冲突。

错误日志 #

npx shadcn@latest add calendar
✔ Checking registry.
⠇ Installing dependencies.
Something went wrong. Please check the error below for more details.
If the problem persists, please open an issue on GitHub.

Command failed with exit code 1: npm install react-day-picker@8.10.1 date-fns @radix-ui/react-slot
npm error code ERESOLVE
npm error ERESOLVE could not resolve
npm error
npm error While resolving: undefined@undefined
npm error Found: react@19.1.0
npm error node_modules/react
npm error   peer react@">=16.8.0" from @floating-ui/react-dom@2.1.2
npm error   node_modules/@floating-ui/react-dom
npm error     @floating-ui/react-dom@"^2.0.0" from @radix-ui/react-popper@1.2.4
npm error     node_modules/@radix-ui/react-popover/node_modules/@radix-ui/react-popper
npm error       @radix-ui/react-popper@"1.2.4" from @radix-ui/react-popover@1.1.10
npm error       node_modules/@radix-ui/react-popover
npm error         @radix-ui/react-popover@"^1.1.10" from the root project
npm error     @floating-ui/react-dom@"^2.0.0" from @radix-ui/react-popper@1.2.2
npm error     node_modules/@radix-ui/react-popper
npm error       @radix-ui/react-popper@"1.2.2" from @radix-ui/react-menu@2.1.6
npm error       node_modules/@radix-ui/react-menu
npm error         @radix-ui/react-menu@"2.1.6" from @radix-ui/react-dropdown-menu@2.1.6
npm error         node_modules/@radix-ui/react-dropdown-menu
npm error       1 more (@radix-ui/react-tooltip)
npm error     1 more (@radix-ui/react-popper)
npm error   peer react@"^16.9.0 || ^17.0.0 || ^18.0.0 || ^19.0.0" from @inertiajs/react@2.0.3
npm error   node_modules/@inertiajs/react
npm error     @inertiajs/react@"^2.0.3" from the root project
npm error   104 more (@radix-ui/react-alert-dialog, ...)
npm error
npm error Could not resolve dependency:
npm error react-day-picker@"8.10.1" from the root project
npm error
npm error Conflicting peer dependency: react@18.3.1
npm error node_modules/react
npm error   peer react@"^16.8.0 || ^17.0.0 || ^18.0.0" from react-day-picker@8.10.1
npm error   node_modules/react-day-picker
npm error     react-day-picker@"8.10.1" from the root project
npm error
npm error Fix the upstream dependency conflict, or retry
npm error this command with --force or --legacy-peer-deps
npm error to accept an incorrect (and potentially broken) dependency resolution.

受影响组件 #

• Calendar（shadcn组件）

复现步骤 #

1. 创建全新的React 19项目
2. 在项目中执行命令：npx shadcn-ui@latest add calendar
3. 触发依赖冲突错误

系统信息 #

系统：macOS
npm 版本：10.8.1
Node.js 版本：v20.16.0

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