如何根据Build Scheme修改Plist变量值？多环境配置方法咨询

嘿，这个需求在iOS/macOS开发里太常见了，我来给你捋几个靠谱的实现方式，都是日常项目里验证过的实用方案：

这是Xcode官方倡导的方式，逻辑清晰、易维护，适合绝大多数项目场景。

• 第一步：创建对应环境的Build Configuration
  打开项目设置（点击项目根节点 → 切换到Info标签），找到Configurations板块。点击左上角的+号，选择Duplicate Debug Configuration，把复制出来的配置改名为Dev；同理再复制出Test、Accept配置，Production环境可以直接用默认的Release，或者也复制一份改名成Production（方便统一管理）。

• 第二步：给每个配置设置专属Plist变量
  这里有两种灵活的实现方式：

  1. 用User-Defined Settings统一管理变量
     切换到项目的Build Settings标签，点击左上角的+号 → Add User-Defined Setting，比如创建API_BASE_URL、APP_DISPLAY_NAME这类变量。然后给每个Configuration（Dev/Test/Accept/Production）设置不同的取值：比如Dev环境填https://dev.yourdomain.com，Test环境填https://test.yourdomain.com。
     接着打开Info.plist，把需要动态替换的字段值改成$(API_BASE_URL)这种格式，编译时Xcode会自动把变量替换成对应环境的取值。
  2. 为不同配置指定独立的Info.plist文件
     如果需要修改的Plist内容特别多，或者不同环境有完全不同的配置项，可以给每个Configuration单独准备一份Info.plist（比如Dev-Info.plist、Test-Info.plist）。在Build Settings → Packaging → Info.plist File里，给每个Configuration指定对应的文件路径即可。

• 第三步：让Scheme关联对应的Configuration
  打开Scheme编辑器（顶部菜单栏Product → Scheme → Edit Scheme），选中你创建的Dev Scheme，在Run、Test、Archive等阶段的Build Configuration下拉框里，选择对应的Dev Configuration。同理给Test、Accept、Production Scheme绑定对应的配置。这样用哪个Scheme编译，就会自动加载对应环境的Plist值。

如果不想创建多个Configuration，只是临时快速实现小范围的Plist值切换，可以用Scheme的Pre-Actions脚本：

• 打开Scheme编辑器，选中目标Scheme（比如Dev），切换到Pre-Actions标签。
• 点击+号 → New Run Script Action，设置Shell为/bin/bash，然后写入修改Plist的脚本，比如：

  # 修改Info.plist里的API_BASE_URL字段
  /usr/libexec/PlistBuddy -c "Set :API_BASE_URL https://dev.yourdomain.com" "${PROJECT_DIR}/YourApp/Info.plist"
  

• ⚠️ 注意：这种方式会直接修改本地的Info.plist文件，所以建议在Post-Actions里加一个恢复脚本，避免提交代码时把测试环境的配置推到仓库，比如：

  # 恢复为Production环境的原始值
  /usr/libexec/PlistBuddy -c "Set :API_BASE_URL https://prod.yourdomain.com" "${PROJECT_DIR}/YourApp/Info.plist"
  

如果你的环境配置项特别多，想把所有配置集中管理，推荐用xcconfig文件：

• 在项目里创建四个xcconfig文件：Dev.xcconfig、Test.xcconfig、Accept.xcconfig、Production.xcconfig。
• 在每个文件里定义环境专属变量，比如Dev.xcconfig里可以写：

  API_BASE_URL = https://dev.yourdomain.com
  APP_DISPLAY_NAME = "My App (Dev)"
  BUNDLE_ID_SUFFIX = .dev
  

• 回到项目设置的Configurations板块，给每个Configuration选择对应的xcconfig文件（比如Dev配置基于Dev.xcconfig）。
• 之后在Info.plist里用$(API_BASE_URL)这样的变量引用即可，效果和User-Defined Settings一致，但配置更集中，方便团队协作维护。

• 代码里可以直接读取这些Plist值，比如Swift代码：

  guard let baseURL = Bundle.main.object(forInfoDictionaryKey: "API_BASE_URL") as? String else {
      fatalError("API_BASE_URL not set in Info.plist")
  }
  // 这里使用baseURL
  

• 除了Plist变量，你还可以给不同Configuration设置不同的签名证书、Team ID、编译选项等，配合Scheme实现从编译到打包的全环境隔离。

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