mac系统 npm 报错 Cannot find module @rollup/rollup-darwin-x64 的解决方法

关键词：npm 报错、Rollup 报错、@rollup/rollup-darwin-x64、Vite 启动失败、optionalDependencies

一、问题背景（我是在什么时候遇到的）

最近在本地启动一个Vite + Vue 项目，执行命令：

npmrun dev

结果项目还没跑起来，终端直接红了一片，核心报错如下：

Error: Cannot find module '@rollup/rollup-darwin-x64' npm has a bug related to optional dependencies

当时第一反应是：

• 是不是 Rollup 配置写错了？
• 依赖版本冲突？
• node 版本不兼容？

结果排查半天发现——代码一点问题没有。