You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

React Native iOS启动报错uses autolinking for native dependencies解决办法

React Native iOS端autolinking相关报错解决方案

这个报错通常由iOS端原生依赖自动链接未生效、Pod依赖安装异常导致,按以下步骤操作即可解决:

  • 第一步:重新安装项目前端依赖
    进入项目根目录,执行命令清空旧依赖文件后重装:
    rm -rf node_modules package-lock.json yarn.lock
    npm install
    # 若使用yarn则替换为 yarn install
    
  • 第二步:重新安装iOS端Pod依赖
    进入ios目录,清空旧Pod文件后重新安装:
    cd ios
    rm -rf Pods Podfile.lock build ~/Library/Developer/Xcode/DerivedData/*
    # Intel芯片Mac执行:
    pod install
    # M系列芯片Mac执行:
    arch -x86_64 pod install
    
  • 第三步:清空缓存重启项目
    回到项目根目录,先启动打包服务并清空缓存:
    npx react-native start --reset-cache
    新开一个终端窗口,执行iOS启动命令:
    npx react-native run-ios

异常排查补充:
若执行完以上步骤仍报错,可逐一排查以下场景:

  1. 检查你安装的第三方原生依赖是否适配当前项目的React Native版本,部分低版本依赖不支持RN的自动链接机制,需要参考依赖官方文档手动配置链接
  2. 打开ios目录下的Podfile,检查是否手动禁用了对应依赖的自动链接,若存在pod 'xxx', :autolinking => false这类配置,可先移除后重新执行Pod安装
  3. 确认Xcode命令行工具已正确配置,执行xcode-select -p查看输出路径是否为Xcode内置开发者工具路径,若输出为/Library/Developer/CommandLineTools,可执行sudo xcode-select -s /Applications/Xcode.app/Contents/Developer修改配置

内容的提问来源于stack exchange,提问作者SoF

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.29 19:54:07