AppCode无法识别CocoaPods安装的类，运行正常却报语法错误求助

这种情况我太熟悉了——代码跑起来完全没问题，但AppCode就是红飘报错，多半是IDE的索引或缓存没跟上CocoaPods的配置，试试下面这些逐个排查的方法：

• 重新同步CocoaPods配置
  先关闭AppCode，打开终端进入你的项目根目录，依次执行以下命令：

  pod deintegrate
  pod install
  

  完成后重新打开AppCode，让IDE重新读取Pods的配置文件，很多时候这一步就能解决索引不匹配的问题。

• 清除AppCode缓存并重启
  缓存混乱是IDE误报的重灾区：

  1. 点击顶部菜单栏的 File -> Invalidate Caches...
  2. 勾选 Clear file system cache and local history
  3. 点击 Invalidate and Restart
     重启后IDE会重新全量索引项目，之前的误报大概率会消失。

• 确认Pods目录被标记为第三方库
  AppCode有时候会把Pods目录当成普通项目代码来检查，导致误判：
  在Project面板找到Pods文件夹，右键点击选择 Mark Directory as -> Library Files。这样IDE会以第三方库的规则来处理它，减少不必要的语法校验。

• 检查项目SDK配置一致性
  确保项目和Pods依赖的SDK版本匹配：

  1. 打开 File -> Project Structure
  2. 在Project Settings -> Project里确认SDK版本
  3. 切换到Modules，检查对应target的SDK设置是否和项目一致
     如果SDK版本不匹配，IDE可能会误判Pods里的代码语法。

• 更新AppCode到最新版本
  部分旧版本的AppCode存在CocoaPods索引的bug，去JetBrains官网下载最新版安装，很多兼容性问题都会在新版本里修复。

如果以上方法都没用，可以尝试备份项目根目录下的.idea文件夹后删除它，然后重新打开项目，让IDE完全重新生成配置文件。

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