React Native自定义字体开发遇react-native-asset模块及配置文件未找到错误

错误信息 #

错误：无法找到模块 'C:\Users\satyen\Desktop\ExpoGame\react-native.config.js'
调用栈：

• C:\Users\satye\node_modules\react-native-asset\lib\cli.js

你在配置自定义字体时遇到上述错误，即便创建了配置文件、全局安装了react-native-asset仍未解决，可按以下步骤排查：

1. 确认配置文件的位置与内容 #

• 确保react-native.config.js放在项目根目录（和package.json同级，也就是ExpoGame文件夹下），不要放子目录里。
• 文件内容需正确导出字体路径，示例：

  module.exports = {
    assets: ['./assets/fonts/'], // 替换为你的字体实际存放路径
  };
  

• 核对路径准确性：确认字体文件确实存在于配置的路径中，路径格式（相对/绝对）要符合项目结构。

2. 规范react-native-asset的安装与调用 #

• 全局安装后，务必在项目本地也安装依赖：

  npm install react-native-asset --save-dev
  

• 执行命令时，确保当前终端处于项目根目录下，再运行：

  react-native-asset
  

• 如果你用的是Expo项目，建议改用Expo官方的字体加载方案（无需react-native-asset）：使用expo-font库，通过Font.loadAsync加载字体。

3. 清除缓存并重试 #

• 清除npm缓存：

  npm cache clean --force
  

• 重置React Native缓存：

  npx react-native start --reset-cache
  

• 重装依赖（Windows系统把第一行换成rd /s /q node_modules）：

  rm -rf node_modules && npm install
  

4. 检查文件权限与名称 #

• 确认react-native.config.js文件名无拼写错误（比如不要写成react-native.config.jsx或大小写混淆）。
• 检查文件是否被系统/杀毒软件锁定，确保有正常读取权限。

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