React Native Expo项目Android打包失败：[BABEL]无法找到'react-native-worklets/plugin'模块

嘿，我之前也碰到过一模一样的问题，别慌，我们先把问题理清楚，再一步步解决它。

问题详情 #

我在运行React Native（Expo）的Android项目时，每次执行 npx expo start 或者构建Android安装包，都会遇到打包失败的错误，具体报错信息如下：

Android Bundling failed 12ms index.js (1 module)
ERROR  Error: [BABEL]: Cannot find module 'react-native-worklets/plugin'
Require stack:
- node_modules/@babel/core/lib/config/files/plugins.js
- ...

这个错误会导致应用完全无法完成打包，而且不管重启多少次打包器都会反复出现。

我的环境信息 #

• React Native: （请填写你的版本）
• Expo SDK: （请填写你的版本）
• Node.js: （请填写你的版本）
• npm / yarn: （请填写你的版本）
• OS: （Windows/macOS/Linux）

我的babel配置文件 #

babel.config.js 的内容是这样的：

module.exports = {
  presets: ['babel-preset-expo'],
  plugins: [
    'react-native-worklets/plugin'
  ],
};

我已经尝试过的修复步骤 #

我试过了常见的缓存和依赖重置方法，但都没效果：

• 删除了 node_modules 文件夹
• 删除了 package-lock.json 文件
• 重新执行 npm install 安装所有依赖
• 用 npx expo start -c 清除了Expo的缓存
• 多次重启Metro打包器
• 甚至重启了我的电脑

解决方法 #

这个问题的核心原因其实很简单：你只在babel配置里引用了react-native-worklets/plugin插件，但没有安装它的核心依赖包react-native-worklets-core。这个babel插件是react-native-worklets-core提供的，所以必须先安装这个包才行。

请按照以下步骤操作：

1. 首先安装核心依赖：
   如果你用npm：

   npm install react-native-worklets-core --save
   

   如果你用yarn：

   yarn add react-native-worklets-core
   

2. 安装完成后，一定要清除缓存再启动项目：

   npx expo start -c
   

额外排查点 #

如果安装后还是出现同样的错误，可以检查以下几点：

• 查看node_modules文件夹里是否存在react-native-worklets目录，如果没有，说明依赖安装失败了，可以尝试删除node_modules和锁文件后重新安装，或者换用yarn来安装（有时候npm会有缓存问题）。
• 如果你是因为使用了某个第三方库（比如react-native-reanimated v3及以上版本）才需要这个插件，要确保第三方库的版本和你的Expo SDK版本兼容，可以对照Expo官方的兼容性对照表来调整版本。

备注：内容来源于stack exchange，提问作者abhinav