Expo创建的React Native项目安装MapBox SDK报错求助

一、先处理安装时的Git错误 #

你遇到的ENOENT spawn git错误，核心原因是系统未安装Git，或Git未添加到系统环境变量PATH中——npm需要调用Git来处理包的下载逻辑。解决步骤：

• 检查Git是否安装：打开终端执行git --version，如果无输出，说明未安装Git，去Git官方渠道下载对应系统的安装包完成安装。
• 确保Git在PATH中：Windows安装时勾选「Add Git to PATH」选项；Mac/Linux安装后重启终端即可，默认已加入PATH。
• 验证：再次执行git --version，能显示版本号即配置成功。

二、重新安装@rnmapbox/maps #

Git问题解决后，按以下步骤重新安装：

1. 清理npm缓存（避免残留问题）：

   npm cache clean --force
   

2. 执行官方包安装命令：

   npm install @rnmapbox/maps --save
   

3. 若仍有问题，尝试用yarn安装（需先安装yarn：npm install -g yarn）：

   yarn add @rnmapbox/maps
   

三、Expo项目使用MapBox的关键注意事项 #

@rnmapbox/maps依赖原生模块，Expo纯托管工作流（managed workflow）无法直接使用，需先转换为裸工作流（bare workflow）：

1. 执行预构建命令转换项目：

   npx expo prebuild
   

2. 配置MapBox Access Token：
   在项目入口文件（如App.js）中添加：

   import Mapbox from '@rnmapbox/maps';
   
   Mapbox.setAccessToken('你的MapBox Access Token'); // 去MapBox平台注册获取
   

3. 测试基础地图组件：
   写一个简单的MapView组件验证：

   import React from 'react';
   import { View, StyleSheet } from 'react-native';
   import Mapbox from '@rnmapbox/maps';
   
   const App = () => {
     return (
       <View style={styles.container}>
         <Mapbox.MapView style={styles.map} />
       </View>
     );
   };
   
   const styles = StyleSheet.create({
     container: { flex: 1 },
     map: { flex: 1 }
   });
   
   export default App;
   

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