按官方文档配置Cocoapods安装MapboxNavigation Pod失败求助

1. 修正.netrc文件配置（注意是.netrc不是.nertc） #

这是最容易出错的环节，文件是用户根目录（~/）下的隐藏文件，内容格式必须严格遵循：

machine api.mapbox.com
login mapbox
password 你的Mapbox Secret Token（必须是Secret类型，且勾选`Downloads:Read`权限）

• 确认Token是Secret类型，Public Token无法用于私有库拉取
• 保存文件后重启终端，再执行pod install

2. 检查Podfile的正确配置 #

Podfile必须包含Mapbox的私有源，同时指定符合版本要求的SDK：

source 'https://cdn.cocoapods.org/'
source 'https://github.com/mapbox/mapbox-cocoapods-specs.git'

platform :ios, '13.0'

target '你的项目名称' do
  use_frameworks!
  pod 'Mapbox-iOS-SDK', '~> 11.0'
  pod 'MapboxNavigation', '~> 2.12'
end

• 不要遗漏Mapbox私有源https://github.com/mapbox/mapbox-cocoapods-specs.git
• 确保iOS部署版本符合SDK要求（当前MapboxNavigation最低要求iOS 13.0）

3. 彻底清理Cocoapods缓存后重装 #

执行以下命令清除缓存及旧配置：

pod deintegrate
pod cache clean --all
rm -rf Podfile.lock
pod repo update
pod install

4. 验证网络与Token有效性 #

• 确认网络可正常访问GitHub及Mapbox API，避免代理或防火墙拦截
• 登录Mapbox账户检查Token是否过期、权限是否被修改

如果仍未解决，建议贴出终端完整报错信息（而非仅截图），便于定位具体问题。

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