VS Code运行Flutter Doctor提示CocoaPods过时的解决方法

现象 #

• 安装VS Code的Flutter插件后，在命令面板执行>Flutter: Run Flutter Doctor，收到如下警告：

  [!] Xcode - develop for iOS and macOS (Xcode 14.2)
  • Xcode at /Applications/Xcode.app/Contents/Developer
  • Build 14C18
  ! CocoaPods 1.8.4 out of date (1.11.0 is recommended).
  CocoaPods is used to retrieve the iOS and macOS platform side's plugin code that responds to your plugin usage on the Dart side.
  Without CocoaPods, plugins will not work on iOS or macOS.
  For more info, see https://flutter.dev/platform-plugins
  To upgrade see https://guides.cocoapods.org/using/getting-started.html#installation for instructions.

• VS Code终端执行gem list pod，显示本地CocoaPods版本为1.12.1：

  ~%gem list pod 
  
  *** LOCAL GEMS ***
  
  cocoapods (1.12.1)
  cocoapods-core (1.12.1)
  cocoapods-deintegrate (1.0.5)
  cocoapods-downloader (1.6.3)
  cocoapods-plugins (1.0.0)
  cocoapods-search (1.0.1)
  cocoapods-trunk (1.6.0)
  cocoapods-try (1.2.0)
  

• VS Code终端与Mac系统终端的dart路径存在差异：

  • VS Code终端：

    ~%which dart
    /Users/{username}/development/flutter/bin/cache/dart-sdk/bin//dart
    

  • Mac系统终端：

    ~%which dart
    /Users/{username}/development/flutter/bin/dart
    

• Mac系统终端运行flutter doctor无异常：

  ~%flutter doctor
  Doctor summary (to see all details, run flutter doctor -v):
  [✓] Flutter (Channel stable, 3.10.2, on macOS 12.6.3 21G419 darwin-x64, locale
      en)
  [✓] Android toolchain - develop for Android devices (Android SDK version 33.0.2)
  [✓] Xcode - develop for iOS and macOS (Xcode 14.2)
  [✓] Chrome - develop for the web
  [✓] Android Studio (version 2022.2)
  [✓] VS Code (version 1.78.2)
  [✓] Connected device (2 available)
  [✓] Network resources
  
  • No issues found!
  

解决方案 #

问题源于VS Code终端未正确加载系统环境变量，导致Flutter检测到的CocoaPods版本异常，可按以下步骤修复：

1. 调整VS Code终端配置
   打开VS Code的settings.json，添加以下配置（以zsh为例），确保终端以登录shell模式启动，加载系统环境变量：

   "terminal.integrated.profiles.osx": {
     "zsh": {
       "path": "/bin/zsh",
       "args": ["-l"]
     }
   },
   "terminal.integrated.defaultProfile.osx": "zsh"
   

2. 重启VS Code验证
   完全关闭VS Code后重新打开，在终端执行which pod确认路径指向正确的CocoaPods版本，再运行flutter doctor检查警告是否消失。

3. 手动指定CocoaPods路径（可选）
   若上述方法无效，直接在Flutter配置中指定CocoaPods的实际路径（可通过系统终端which pod获取）：

   flutter config --set cocoapods_path /usr/local/bin/pod
   

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