安装cordova-plugin-screen-orientation后npx cap sync卡顿超时求解决方案

数据老陈

2026-7-1

修复 npx cap sync 搭配 cordova-plugin-screen-orientation 同步过慢的方案

清理缓存重置依赖
直接删掉冗余缓存文件，重新安装依赖并清理iOS平台：
```
rm -rf node_modules package-lock.json
npm install
npx cap clean ios
npx cap sync ios
```
缓存堆积经常会导致Capacitor解析依赖时出现异常拖慢，重置后大概率能恢复正常速度。
替换为Capacitor原生方向插件
既然用Capacitor，没必要硬套Cordova插件，官方的@capacitor/screen-orientation完全适配，不会有兼容问题：
```
npm uninstall cordova-plugin-screen-orientation
npm install @capacitor/screen-orientation
npx cap sync ios
```
用法和Cordova版本差不多，但同步时不会触发Cordova到Capacitor的兼容层额外处理，速度会快很多。
优化iOS Pod源
M系列Mac有时候访问默认Pod源速度慢，换国内镜像或者更新源：
编辑ios/App/Podfile，替换或添加源：
```
source 'https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git'
source 'https://cdn.cocoapods.org/'
```
然后执行：
```
cd ios/App
pod repo update --verbose
cd ../..
npx cap sync ios
```
确保Pod依赖能快速拉取，避免卡在依赖安装环节。
临时关闭Xcode自动索引
同步过程中Xcode的自动索引会占用大量资源，拖慢同步速度：
打开Xcode → 设置 → 文本编辑 → 代码补全，取消勾选"Index While Building"，完成同步后再重新开启即可。