Expo Vector Icons在Android及iOS开发构建中不显示的问题

问题背景 #

我引入了多个Expo图标库：

import { Ionicons,FontAwesome5,FontAwesome,AntDesign ,MaterialCommunityIcons} from '@expo/vector-icons';

这些图标在iOS Expo Go和TestFlight环境显示正常，但iOS本地开发构建中完全不显示，Android全环境也无法加载。报错信息如下：

[Unhandled promise rejection: Error: The method or property expo-file-system.downloadAsync is not available on ios, are you sure you've linked all the native dependencies properly?]

堆栈追踪显示错误源于expo-font加载图标字体时，调用expo-file-system.downloadAsync失败。

核心原因 #

Expo Go和EAS构建（TestFlight）会自动完成所有Expo官方模块的原生依赖链接，但本地开发构建（expo run:ios/android）需要手动确保依赖正确安装与集成，当前问题本质是expo-file-system的原生模块未正确配置。

解决步骤 #

1. 安装匹配SDK版本的expo-file-system #

执行以下命令，自动安装与当前Expo SDK完全兼容的版本，避免版本不兼容问题：

npx expo install expo-file-system

2. 修复iOS开发构建问题 #

• 重新安装iOS Pod依赖：

  npx pod-install ios
  

• 重新构建自定义开发客户端：

  npx expo run:ios --configuration Development
  

3. 修复Android开发构建问题 #

• 清理Gradle缓存：

  cd android && ./gradlew clean
  

• 重新构建Android项目：

  npx expo run:android
  

4. 清除Expo缓存 #

清除项目缓存，避免旧构建残留导致的异常：

npx expo start --clear

5. 验证字体加载逻辑（可选） #

虽然@expo/vector-icons会自动处理字体加载，但如果手动管理过字体加载流程，确保启动代码无错误：

import * as Font from 'expo-font';
import { Ionicons, FontAwesome5 } from '@expo/vector-icons';

await Font.loadAsync({
  ...Ionicons.font,
  ...FontAwesome5.font,
  // 其他图标库字体
});

内容的提问来源于stack exchange，提问作者Aatish Parson