根本不是VSCode的问题，而是其启动的shell环境未加载LANG和PATH：VSCode终端手动pod install正常，但构建时因子进程不source配置导致LANG为空，需在~/.zshrc中export LANG=en_US.UTF-8并source，或项目根目录加.env文件；同时须确保pod repo update完成、使用.xcworkspace而非.xcodeproj。
CocoaPods 在 VSCode 中运行失败，根本不是 VSCode 的问题，而是它启动的 shell 环境没加载正确的 LANG 和 PATH —— 尤其是当你用 VSCode 启动 iOS 构建（比如通过 uni-app 或 Flutter 插件）时，它默认不读 ~/.bash_profile 或 ~/.zshrc。
VSCode 终端里 pod install 正常，但项目构建时报 CocoaPods requires your terminal to be using UTF-8 encoding
这是最典型的「环境错位」：你在 VSCode 内置终端手动执行 pod install 时，终端已加载了你的 shell 配置（比如 ~/.zshrc），所以 $LANG 是 en_US.UTF-8；但 VSCode 启动构建流程（如 uni-app 的 npm run build:app-plus）时，它用的是一个「干净」的子进程 shell，不 source 任何配置文件。
- 验证方式：在 VSCode 中打开「终端」→ 输入
echo $LANG，再执行构建命令 → 在构建日志里搜LANG=，大概率看到空值或C - 直接修复：在项目根目录下创建
.env文件（注意不是.env.local），写入：LANG=en_US.UTF-8 LC_ALL=en_US.UTF-8
- uni-app 用户额外注意：
build:app-plus脚本底层调用的是 HBuilderX 的构建逻辑，它会读取系统环境变量，但不会自动注入.env；所以必须确保 macOS 全局环境生效 —— 编辑~/.zshrc（macOS Catalina 及之后默认用 zsh），添加：export LANG=en_US.UTF-8 export LC_ALL=en_US.UTF-8
，然后执行source ~/.zshrc
pod install 报 Unable to find a specification for XXX
这不是网络卡顿，而是本地 CocoaPods repo 没同步或损坏。VSCode 不会自动帮你跑 pod repo update，而很多插件（如 uni-app 的 uts 插件构建）只调 pod install，跳过了这步。
- 先确认 repo 状态：
pod repo list，看master是否存在且最后更新时间合理（比如近 7 天内） - 如果
master显示(Not downloaded yet)或更新时间过旧，手动执行：pod repo update - 国内用户务必检查源是否被墙：
gem sources -l，若显示https://rubygems.org/，立即换源：gem sources --remove https://rubygems.org/ gem sources -a https://ruby.taobao.org/
（注意：淘宝源已于 2023 年停服，现推荐用https://gems.ruby-china.com/） - uni-app 用户注意：
config.json中的dependencies-pods依赖项，只有在pod repo有对应 spec 时才能解析成功，否则构建直接中断
真机运行时报 framework not found XXX 或 ld: library not found for -lXXX
说明 Pod 生成的 .xcframework 或静态库没被 Xcode 正确链接 —— VSCode 自身不参与 Xcode 工程配置，但它触发的构建流程可能跳过了 pod install 后的 Xcode 工程重载步骤。
- 关键动作：每次修改
Podfile或config.json的dependencies-pods后，必须手动在项目根目录执行：pod install --repo-update（加--repo-update强制同步） - 检查生成物：
ios/Pods/目录是否存在；ios/{YourProject}.xcodeproj/project.pbxproj里是否新增了Pods.xcodeproj的引用；ios/{YourProject}.xcworkspace是否存在且能用 Xcode 打开 - VSCode 用户容易忽略的一点：uni-app 构建脚本默认打开的是
.xcodeproj，但 CocoaPods 要求你用.xcworkspace；所以真机调试前，务必用 Xcode 手动打开.xcworkspace，选中设备，点一次「Build」，让 Xcode 初始化所有 linking 配置 - 如果仍报 framework not found，打开 Xcode → Target → Build Settings → 搜索
Framework Search Paths，确认包含$(PROJECT_DIR)/Pods/.../Frameworks路径
真正麻烦的从来不是装不上 CocoaPods，而是 VSCode 和 Xcode 之间那层看不见的环境与工程状态同步 —— 它不报错，只静默失败；你得亲手验证 LANG、repo、.xcworkspace 三个环节是否都到位，缺一不可。
