Xcode 27.2 Adopts JSON Project Format to Enhance AI Agent Compatibility

苹果在 Xcode 27.2 中引入基于 JSON 的新项目配置格式（xcode-project-format），替代原有 plist 格式，提升可读性、可维护性与工具链兼容性。

支持 Git 变更精准比对，降低合并冲突；结构化表示增强 AI 编码智能体对项目配置的理解与修改能力；配套开源 Swift 包提供序列化/反序列化能力。

适合 iOS 工程师、DevOps 工程师、AI 编码工具开发者阅读。

苹果推出基于 JSON 的全新 Xcode 项目配置文件格式，用以取代传统的基于属性列表（property-list）的格式。新格式在 Xcode 27.2 中可用，旨在提升可读性、简化维护工作，并让 AI 编码智能体更容易理解和修改项目配置。

使用开源的 JSON 文件格式（xcode-project-format），在将项目配置文件提交到代码仓库后更便于校验项目配置变更，因为对比视图中的改动与 Xcode 中的操作一一对应。

新格式的一个主要优势在于，它通过提供更稳定、更可预测的项目配置表示方式降低了合并冲突的可能性。JSON 格式还让项目结构对包括 AI 编码智能体在内的自动化开发工具更加友好，简化了项目设置的检查和修改。

为帮助开发者使用这种新格式，苹果还发布了一个用于编码和解码该格式的 Swift 包。例如，以下是如何列出项目中定义的所有 target：

import XcodeProjectFormatfunc listTargets(in projectURL: URL) throws {    let projectData = try Data(contentsOf: projectURL)    let project = try XCSchema.Project(jsonRepresentation: projectData)    for target in project.targets {        print(target.name)    }}

复制代码

在顶层，JSON Schema 不仅定义了 target，还定义了文件树、构建配置、构建设置和外部依赖。它还支持不同子树中节点之间的关联关系。例如，一个文件可以指定它所属的构建阶段和 target。重要的是，该格式尽可能避免使用不透明的标识符，优先使用可读的名称和路径。Target 和构建产物例外，它们使用标识符来支持外部文件引用。

资深 iOS 开发者 Nikita Dyachkov 在评论此消息时指出：

合并项目文件的问题自项目文件诞生以来就一直存在，任何在多人 iOS 开发团队中工作过的人都对此深有体会。

在同一条讨论帖中，资深 iOS 工程师 Khushal Jhalani 评价这种可读性更强的新格式“大幅提升了开发体验”。不少人也认同这项改动姗姗来迟，资深 iOS 开发者 Moumita China 表示，如果早点推出，本可以免去“多年的合并冲突困扰”。

现有项目可轻松迁移，因为新格式仅改变项目在磁盘上的存储形式，底层模型不变。项目转换后，传统的 project.pbxproj 文件会替换为 project.xcproj。不过，在迁移之前请确认你正在使用的工具（包括 fastlane、CocoaPods、Tuist 等）均支持新格式。

查看英文原文：https://www.infoq.com/news/2026/10/xcode-json-project-format/