当在 macOS Catalina 10.15.7 上运行 npm start --reset-cache 启动 React Native Metro 服务时，出现 “No Metro config found” 错误，通常因项目缺少 metro-config 依赖导致；本文提供快速修复方法及预防措施。

当在 macos catalina 10.15.7 上运行 `npm start --reset-cache` 启动 react native metro 服务时，出现 “no metro config found” 错误，通常因项目缺少 `metro-config` 依赖导致；本文提供快速修复方法及预防措施。

React Native 项目在初始化后（尤其是较新版本如 0.72+ 或使用自定义模板创建时），可能未自动安装 metro-config，而 Metro 打包器在启动时会主动查找该模块以加载默认或自定义配置。若缺失，即使项目结构完整、依赖已安装，也会直接报错并中断启动流程。

✅ 快速修复方案
在项目根目录下执行以下命令，安装 Metro 配置所需的开发依赖：

npm install metro-config --save-dev

? 提示：若使用 Yarn，请改用 yarn add metro-config --dev；若项目使用 pnpm，则运行 pnpm add -D metro-config。

安装完成后，再次运行：

npm start --reset-cache

或更推荐的组合命令（清除缓存 + 重启）：

npx react-native start --reset-cache

✅ 进阶验证与可选优化

Ainative React Sdk

使用 @ainative/react-sdk 为 React 应用添加 AI 聊天和积分。适用于 (1) 安装 @ainative/react-sdk，(2) 使用 useChat hook 实现聊天完成。

下载

• 检查是否已生成默认 Metro 配置文件：现代 React Native CLI 通常无需手动创建 metro.config.js，但若需定制（如排除 node_modules、添加 sourceExts），可在项目根目录新建该文件：

  // metro.config.js
  const { getDefaultConfig } = require('expo/metro-config'); // Expo 项目
  // 或对于纯 React Native：
  // const { getDefaultConfig } = require('metro-config');
  
  const defaultConfig = getDefaultConfig(__dirname);
  
  module.exports = {
    ...defaultConfig,
    resolver: {
      ...defaultConfig.resolver,
      assetExts: [...defaultConfig.resolver.assetExts, 'db'],
    },
  };

• 确保 package.json 中 scripts 区域包含标准启动脚本：

  "scripts": {
    "start": "react-native start",
    "android": "react-native run-android",
    "ios": "react-native run-ios"
  }

⚠️ 注意事项

• 不要全局安装 metro-config —— 它必须作为项目本地开发依赖存在；
• --reset-cache 参数本身不会修复依赖缺失，仅清空 Metro 缓存，因此务必先补装依赖；
• 若使用 Expo 开发环境（Expo Go 或 EAS Build），请优先遵循 Expo 官方配置指南，因其 Metro 集成方式略有差异；
• 升级 React Native 版本后，建议同步检查 React Native Upgrade Helper 中关于 Metro 的变更说明。

通过以上步骤，绝大多数因 No Metro config found 导致的启动失败问题均可立即解决，并为后续 Android/iOS 调试奠定稳定基础。