Xcode 27正式发布：系统要求、部署目标，以及哪些东西坏了

Xcode 27于2026年9月14日以构建版本27A266a发布，距信息源中出现iOS 27.0 RC条目仅三天，与iOS 27.0（24A437）、macOS 27.0（26A428）以及其余27系平台同日推出。App Store Connect当天开始接受用27.0 GA SDK构建的版本，而RC SDK构建的版本自9月9日起就已可以上传。¹⁵ 它要求macOS Tahoe 26.6或更高版本以及Apple silicon Mac，附带Swift 6.4和27系SDK，可调试运行iOS 17或更高版本的设备，并上调了三个最低部署目标：macOS 12、watchOS 9和DriverKit 21。²³ 对于现有项目，它带来三处必然失败的变化（@State宏、SE-0508造成的源代码兼容性破坏，以及-ld64链接器标志）、一条可能报错的依赖扫描规则、一处对ARCHS_STANDARD的静默更改，还有两条警告。下文的每一项我都在27A266a上实际运行过。²⁴⁶

TL;DR

• 日期与构建版本。 Apple的Releases信息源将Xcode 27（27A266a）和全部六个27.0操作系统列在9月14日星期一；其“iOS 27.0 RC (24A437)”条目标注的日期是9月11日星期五，也就是App Store Connect开始接受RC SDK上传两天之后，而GA版沿用同一个构建号。¹⁵ App Store Connect自己9月14日的发布说明写明，现在可以上传用Xcode 27构建的App，用于App Store和TestFlight。⁵
• 系统要求和下限变了。 Xcode 26.6可在macOS 26.2上运行并调试iOS 15设备；Xcode 27需要macOS 26.6，仅在Apple silicon上运行，只能调试iOS 17、tvOS 17和watchOS 10或更高版本，模拟器和真机都是如此。最低部署目标从macOS 11升到12、watchOS 8升到9、DriverKit 20升到21；iOS、iPadOS和tvOS仍为15，visionOS仍为1。²³
• 三处必然失败。 @State宏：Apple自己的示例，即在其他存储属性之前给一个带有声明处初始值的@State属性赋值的初始化器，会以variable 'self.title' used before being initialized失败；一个带有数组或字典字面量初始值和init访问器的计算属性，如果getter写在前面就无法编译，Apple将这一源代码兼容性破坏归因于SE-0508；而Xcode 15曾写进文档的-ld64链接器标志，会以ld: library 'd64' not found导致链接失败。²⁴⁶⁸
• 四处会警告、可能报错或一声不吭的变化。 由于ld64已不复存在，链接器会忽略-ld_classic并给出警告；同一次依赖扫描中重复的Clang模块名“may report an error”（可能报告错误）；设为27.0的纯macOS目标只会构建arm64，除非你把x86_64加回去，而且没有任何警告；PreviewProvider带有27.0的弃用标记，消息是“Use #Preview instead.”，每个预览修饰符也各有自己的替代消息，但在低于27.0的部署目标下，编译器一条都不会显示。²⁴
• 截至9月15日，Apple尚未发布Xcode 27.1。 Releases信息源和发布说明索引都没有列出它，Apple的iPhone Duo开发者页面仍把27.1 beta标注为“later this month”（本月晚些时候）；我在Duo开发者文章中描述的SDK空窗期依然存在。¹（9月17日：仍然没有27.1，但Xcode 27.2 beta已于9月16日发布，其说明点名27.1就是承载Duo SDK的那个版本；详情见下文更新。⁹）（9月19日：Xcode 27.1 beta（27A9269）于9月18日发布，附带iOS 27.1 SDK；下面第二则更新载有其说明。¹⁰）（10月1日：27.1仍然只有那第一个beta。¹¹）（10月11日：Xcode 27.1 RC（27A9275）已于10月5日发布，这是RC而非正式版；App Store Connect当天的条目写道：“You can now upload apps built with Xcode 27.1 RC using the SDK for iOS 27.1, iPadOS 27.0, macOS 27.0, tvOS 27.0, visionOS 27.0, and watchOS 27.0 for the App Store, and for internal and external testing through TestFlight.”（现在可以上传用 Xcode 27.1 RC、以 iOS 27.1、iPadOS 27.0、macOS 27.0、tvOS 27.0、visionOS 27.0 和 watchOS 27.0 SDK 构建的应用，用于 App Store，以及通过 TestFlight 进行的内部和外部测试）¹²）（10月14日：Xcode 27.2 beta 3（27B5038j）已发布；Xcode 27.1仍停留在RC，正式版仍是Xcode 27；下面第四则更新载有beta 3的说明。¹³）（10月15日：Xcode 27.1（27A9275）已成为正式版，构建号与RC相同，在Releases信息源中的日期为太平洋时间13:00；发布说明页面已改名，App Store Connect当天的条目以这个名称接受其构建上架商店；Xcode 27不再是最新的正式版。¹⁴）

更新，9月17日：27.2 beta先到了，27.1有了自己的任务

Apple的Releases信息源将一整波27.2 beta列在9月16日星期三：Xcode 27.2 beta（27B5019j）、iOS和iPadOS 27.2 beta（24B5084k）、macOS 27.2 beta（26B5086k）、tvOS 27.2 beta（24K5088l）、visionOS 27.2 beta（24N5088l）和watchOS 27.2 beta（24S5086l），外加一次TestFlight更新，而信息源中没有任何条目提到27.1。⁹ Xcode 27.2 beta的发布说明用一句话解释了这个空缺：“The iOS SDK and simulator support for iPhone Duo will be available later this month in an upcoming release of Xcode 27.1.”（面向iPhone Duo的iOS SDK和模拟器支持将于本月晚些时候随即将发布的Xcode 27.1提供）所以，27.1承载Duo SDK，27.2是一个带有自己新功能的独立beta，而这个beta保持了GA版的下限：“Xcode 27.2 beta requires a Mac running macOS Tahoe 26.6 or later.”（Xcode 27.2 beta要求Mac运行macOS Tahoe 26.6或更高版本）⁹

那份beta说明中有两个条目可为本文补充，而下文引用的模拟器运行时已知问题141290052在27.2中仍未解决。Project Format之下：“Xcode now supports a JSON-based project format (.xcproj) that’s more readable, merge-friendly, and easier for coding agents to edit,”（Xcode现在支持一种基于JSON的项目格式（.xcproj），它更易读、更利于合并，也更便于编码代理编辑），可在文件检查器中启用，以及“Projects using .xcproj also open in earlier versions of Xcode 27.”（使用.xcproj的项目也能在更早版本的Xcode 27中打开）SDK之下有一条已知问题：“macOS, watchOS, tvOS, and visionOS SDKs in Xcode 27.2 incorrectly report 27.1 as a valid deployment target,”（Xcode 27.2中的macOS、watchOS、tvOS和visionOS SDK错误地把27.1报告为有效的部署目标），并伴随“unexpected behavior if this deployment target is used,”（若使用该部署目标，会出现意外行为）以及“Mac Catalyst builds with a 27.1 or 27.2 deployment target may be unable to use newly introduced API.”（部署目标为27.1或27.2的Mac Catalyst构建可能无法使用新引入的API）⁹ 在我9月16日和9月17日的两次获取之间，Apple还给Xcode 27的说明本身添加了一条已知问题，位于Enhanced Security之下：“Apps with Hardware-Checked Pointer Arithmetic Slice feature enabled cannot be uploaded to the App Store on macOS Tahoe 26.6 with Xcode automatic signing enabled.”（启用了Hardware-Checked Pointer Arithmetic Slice功能的App，在macOS Tahoe 26.6上开启Xcode自动签名时无法上传到App Store）变通方法是“Distribute with macOS 27 and Xcode 27 or use manual signing.”（使用macOS 27和Xcode 27分发，或改用手动签名）我的arm64e.x1文章已收录这一条。⁹ 27.2 beta的说明中没有任何内容涉及链接器、模块名规则、@State宏或下文的预览弃用；前三项写在Xcode 27的说明里，@State条目写在iOS和iPadOS 27的说明里，而本文引用的Xcode 27条目在9月17日读到的与9月15日别无二致。⁶⁹

更新，9月19日：Xcode 27.1 beta已发布，带来iOS 27.1 SDK

Apple的Releases信息源把Xcode 27.1 beta（27A9269）列在9月18日星期五，比27.2 beta那一波晚两天；Xcode发行说明索引现在列出三个27系列条目：Xcode 27、Xcode 27.1 Beta和Xcode 27.2 Beta。¹⁰ 27.1 beta的说明很短。其Overview写道：“Xcode 27.1 beta includes Swift 6.4 and SDKs for iOS 27.1, iPadOS 27, tvOS 27, watchOS 27, macOS 27, and visionOS 27,”（Xcode 27.1 beta包含Swift 6.4以及iOS 27.1、iPadOS 27、tvOS 27、watchOS 27、macOS 27和visionOS 27的SDK），真机调试的下限与27.0相同，要求也相同：“a Mac running macOS Tahoe 26.6 or later.”（运行macOS Tahoe 26.6或更高版本的Mac）。这份SDK清单请按原文理解，但有一处出入：Overview把iPadOS写作27，而下面App Store Connect的那句话和Apple的API页面都说iPadOS 27.1 beta；我两者照录，不做裁定。iOS 27.1正是Apple 9月16日新闻中所说iPhone Duo于10月23日上市时“will run”（将运行）的版本。¹⁰ App Store Connect的发行说明在9月18日的TestFlight条目下有对应的一句：“You can now submit apps built with Xcode 27.1 beta using the SDK for iOS 27.1 beta or iPadOS 27.1 beta for internal and external testing.”（现在可以提交用Xcode 27.1 beta、以iOS 27.1 beta或iPadOS 27.1 beta SDK构建的应用，用于内部和外部测试）¹⁰ 在我9月17日与9月19日两次抓取之间，Apple还改写了27.2 beta说明的Overview：上文更新中引用的那句“The iOS SDK and simulator support for iPhone Duo will be available later this month in an upcoming release of Xcode 27.1,”已经不见，取而代之的是一条带下载页链接的提示：“Download Xcode 27.1 beta to get the iOS SDK and simulator support for iPhone Duo,”（下载Xcode 27.1 beta以获取iPhone Duo的iOS SDK和模拟器支持）。¹⁰ Apple的文档现在把iPhone Duo的五个API标为iOS 27.1、beta；名称见我的Duo开发者文章。

27.1 beta的说明有三个部分，其中两个是Known Issues（已知问题）。Mac Catalyst部分：“Projects that use APIs specific to iOS 27.1 show compile errors when building for Mac Catalyst (“undeclared identifier”, “not found”, “has no member”, “cannot find”, etc).”（使用iOS 27.1专有API的项目在为Mac Catalyst构建时会出现编译错误）（185924957），解决办法是“Use build-time conditionals like #if !targetEnvironment(macCatalyst) (Swift) or #if !TARGET_OS_MACCATALYST (ObjC) to isolate affected code,”（用构建时条件隔离受影响的代码）；以及“Projects that target iOS 27.1 show no Mac Catalyst run destination available.”（以iOS 27.1为目标的项目不显示任何Mac Catalyst运行目标）（187046347），解决办法是“Add a Mac Catalyst 27.0 minimum deployment in target settings.”（在目标设置中添加Mac Catalyst 27.0最低部署版本）。它们与9月17日更新中引用的27.2 beta的SDK已知问题187160501并列；照我的理解，那是同一个27.1缺口从macOS SDK一侧看到的样子。Simulator部分有三个已知问题：“Initial Simulator launch can take several minutes.”（模拟器首次启动可能需要几分钟）（187708500）、“StandBy is unavailable in the iPhone Duo Simulator runtime.”（iPhone Duo模拟器运行时不提供待机显示）（187708663）和“Running and debugging most app extensions is unavailable in the iPhone Duo Simulator runtime.”（iPhone Duo模拟器运行时无法运行和调试大多数App Extension）（187708767）。第三部分Previews有一项New Feature：“The canvas overrides picker now includes a Display group for previewing content on a device’s alternative display.”（画布覆盖选择器新增Display分组，可在设备的另一块显示屏上预览内容）（182598534）。¹⁰ 27.1 beta的说明没有涉及链接器、模块名规则、@State宏或下文的预览弃用，而9月19日重新抓取的Xcode 27说明与9月17日一致。¹⁰

还有一个日期该记进这篇文章，来自Apple 9月9日关于App Store提交的新闻：“Starting April 2027, apps and games uploaded to App Store Connect need to meet the following minimum requirements: iOS and iPadOS apps must be built with the iOS 27 & iPadOS 27 SDK or later,”（从2027年4月起，上传到App Store Connect的应用和游戏必须满足以下最低要求：iOS和iPadOS应用必须用iOS 27和iPadOS 27 SDK或更高版本构建），tvOS、visionOS和watchOS应用同样以各自的27 SDK为准。截至9月19日，Apple的Upcoming Requirements页面尚未列出这一条，最新条目仍是2026年4月28日的Xcode 26和26系列SDK下限。所以，本文所写的27系列SDK将在2027年4月成为上传的下限。¹⁰

更新，10月1日：Xcode 27.2 beta 2已发布，没有Xcode 27.0.1

Apple的Releases信息源将Xcode 27.2 beta 2（27B5028f）列在9月28日星期一，与iOS、iPadOS、macOS、visionOS和watchOS的27.0.1更新同一天。信息源中没有Xcode 27.0.1：正式版当时仍是Xcode 27（27A266a），其发布说明页面的正文与我9月26日保存的副本完全相同。¹¹ beta 2的说明新增了一个GetCodeCoverage MCP工具，把第一个beta中Device Hub的输入问题列为已修复；它仍把iPhone Duo相关工作指向Xcode 27.1 beta，却自己列出了两项iPhone Duo已知问题，还重复了9月19日更新中引用过的两个27.1 beta条目，即185924957和182598534；27.2一文逐条解读了这些内容。下文引用的模拟器运行时问题141290052，在27.2 beta 2中已列为修复；Xcode 27仍将其列为Known Issue。¹¹

更新，10月14日：Xcode 27.2 beta 3已发布，Duo提示消失了

Apple的Releases信息源将Xcode 27.2 beta 3（27B5038j）列在10月14日星期三，即iOS、iPadOS、macOS、visionOS和watchOS第四个27.2 beta发布的次日（tvOS没有）。正式版当时仍是Xcode 27（27A266a），Xcode 27.1也仍停留在10月5日的RC（10月15日：Xcode 27.1于当天下午以RC的构建27A9275作为正式版发布，见下面第五则更新），Xcode 27发布说明页面的正文与我10月11日保存的副本相比没有变化。¹³ beta 3的说明删去了把iPhone Duo相关工作指向Xcode 27.1 beta的那条提示，也没有补上任何内容，因此没有任何地方说Duo SDK已移到27.2，而按我的理解，Duo所用的构建仍是27.1 RC；说明还新增了两项针对toolchain编译模式的Interface Builder修复，把模拟器克隆问题移到Simulator Runtimes标题之下，并给出一条find命令作为规避方法，又把运行时重新安装问题187950199改列为在beta 2中已解决；27.2一文逐条解读了这些条目。下文引用的模拟器运行时问题141290052是另一个条目，它仍列为在27.2 beta 2中已修复，在Xcode 27页面上也仍是Known Issue。App Store Connect同一天的TestFlight条目接受用27.2 beta 3构建的版本，但只用于测试，不能用于上架App Store。¹³

更新，10月15日：Xcode 27.1成为正式版，构建号与RC相同

Apple的Releases信息源将Xcode 27.1（27A9275）列在10月15日星期四太平洋时间13:00，比iPhone Duo在10月23日发售早八天；构建号就是10月5日那个RC的构建号。¹⁰¹²¹⁴ 发布说明页面改名为“Xcode 27.1 Release Notes”，Overview写道“Xcode 27.1 includes Swift 6.4 and SDKs for iOS 27.1, iPadOS 27, tvOS 27, watchOS 27, macOS 27, and visionOS 27.”（Xcode 27.1 包含 Swift 6.4 以及 iOS 27.1、iPadOS 27、tvOS 27、watchOS 27、macOS 27 和 visionOS 27 的 SDK），也就是RC的原文去掉了“RC”，两个iPhone Duo Simulator已知问题仍然保留。App Store Connect同一天的条目写道：“You can now upload apps built with Xcode 27.1 using the SDK for iOS 27.1, iPadOS 27.0, macOS 27.0, tvOS 27.0, visionOS 27.0, and watchOS 27.0 for the App Store, and for internal and external testing through TestFlight.”（现在可以上传用 Xcode 27.1、以 iOS 27.1、iPadOS 27.0、macOS 27.0、tvOS 27.0、visionOS 27.0 和 watchOS 27.0 SDK 构建的应用，用于 App Store，以及通过 TestFlight 进行的内部和外部测试），并补充：“Submit your iPhone Duo optimized apps and games in App Store Connect today. Starting April 2027, any apps or games submitted will need to include screenshots for iPhone Duo.”（今天就在 App Store Connect 中提交为 iPhone Duo 优化的应用和游戏。自2027年4月起，提交的任何应用或游戏都需要包含 iPhone Duo 截图）。Xcode 27（27A266a）仍作为9月14日的正式版留在信息源中，Xcode 27发布说明页面与10月11日的副本相比没有变化。27.2一文和Duo准备一文也有同样的注记。¹⁴

更新，10月26日：27.2各系统已发布，Xcode 27.2仍是RC

Apple的Releases信息源把iOS 27.2（24B119，同一分钟还有第二个iOS 27.2构建24B91020）、iPadOS 27.2（24B119）、macOS 27.2（26B123）、tvOS 27.2（24K122）、visionOS 27.2（24N120）和watchOS 27.2（24S118）列在10月26日星期一太平洋时间10:00。信息源中最新的Xcode条目仍是候选版本Xcode 27.2 RC（27B48），日期为10月19日太平洋时间10:00，它的发布说明页面标题也仍是“Xcode 27.2 RC Release Notes”，Overview写道：“Xcode 27.2 RC includes Swift 6.4 and SDKs for iOS 27.2, iPadOS 27.2, tvOS 27.2, watchOS 27.2, macOS 27.2, and visionOS 27.2. Xcode 27.2 RC supports on-device debugging in iOS 17 and later, tvOS 17 and later, watchOS 10 and later, and visionOS. Xcode 27.2 RC requires a Mac running macOS Tahoe 26.6 or later.”（Xcode 27.2 RC 包含 Swift 6.4 以及 iOS 27.2、iPadOS 27.2、tvOS 27.2、watchOS 27.2、macOS 27.2 和 visionOS 27.2 的 SDK。Xcode 27.2 RC 支持在 iOS 17 及更高版本、tvOS 17 及更高版本、watchOS 10 及更高版本以及 visionOS 上进行设备调试。Xcode 27.2 RC 需要运行 macOS Tahoe 26.6 或更高版本的 Mac。）App Store Connect在10月20日的条目接受了用它构建的版本：“You can now upload apps built with Xcode 27.2 RC using the SDK for iOS 27.2 RC, iPadOS 27.2 RC, macOS 27.2 RC, tvOS 27.2 RC, visionOS 27.2 RC, and watchOS 27.2 RC for the App Store, and for internal and external testing through TestFlight.”（现在可以上传用 Xcode 27.2 RC、以 iOS 27.2 RC、iPadOS 27.2 RC、macOS 27.2 RC、tvOS 27.2 RC、visionOS 27.2 RC 和 watchOS 27.2 RC SDK 构建的应用，用于 App Store，以及通过 TestFlight 进行的内部和外部测试。）9月时，Xcode 27与27.0各系统在同一天发布；这一次，各系统发布时没有带上它。RC页面在beta 3的基础上新增了：一份Device Hub功能列表（慢动作动画，为模拟器模拟摇晃、跌落和内存压力，截图上下文菜单，截图图标改进的拖放，隐藏边框，以及App Settings分组，189236369）；针对没有visionOS运行时时Vision Pro崩溃、内存警告菜单项，以及Device Hub在较早的macOS 27.2 beta上退出（190126101）的修复；一项Device Hub已知问题，即它“is unable to customize the text size for a device running iOS 18 or earlier”（无法为运行iOS 18或更早版本的设备自定义文字大小）（189261485）；一项针对CameraCaptureAccessory同时使用两块显示屏的iPhone Duo模拟器修复（190155353）；一项新的iPhone Duo模拟器已知问题，“When switching between the inner and outer display of the iPhone Duo simulator, modifier keys such as Shift and Command might stop working.”（在iPhone Duo模拟器的内屏和外屏之间切换时，Shift和Command等修饰键可能失灵。）（189465196）；以及Instruments、Memory Gauge和XCTest UI Automation各一项修复。macOS、watchOS、tvOS和visionOS SDK会“incorrectly report 27.1 as a valid deployment target”（错误地把27.1报告为有效的部署目标）这一SDK已知问题没有变化，关于“APIs specific to iOS 27.1”（iOS 27.1专有的API）的Mac Catalyst条目也没有变化。在这两个Xcode条目之间，iPhone Duo发售了：Apple新闻编辑室把它在零售店的首次亮相定在10月23日星期五，Apple的安全更新页面列出的iOS 27.1只对应“iPhone Duo”，日期为10月23日，没有已公开的CVE条目；信息源中从未出现过iOS 27.1条目，发行说明索引也只列出27和27.2，所以Xcode 27.1所带的27.1 SDK（这台Mac上的构建号为24A94232），是一个只在一款手机上发布的iOS版本的SDK。10月22日的TestFlight 4.4.1加入了“Support for iPhone Duo”（对iPhone Duo的支持）。iOS 27.2发行说明一文解读了27.2的说明，27.2 beta一文则保留了beta的记录。¹⁵

9月14日发布了什么？

发布说明的Overview写道：“Xcode 27 includes Swift 6.4 and SDKs for iOS 27, iPadOS 27, tvOS 27, watchOS 27, macOS 27, and visionOS 27. Xcode 27 supports on-device debugging in iOS 17 and later, tvOS 17 and later, watchOS 10 and later, and visionOS. Xcode 27 requires a Mac running macOS Tahoe 26.6 or later.”（Xcode 27包含Swift 6.4和各27系SDK，支持在iOS 17及更高版本、tvOS 17及更高版本、watchOS 10及更高版本以及visionOS上进行真机调试，并要求Mac运行macOS Tahoe 26.6或更高版本）² 在这台Mac上，xcodebuild -version输出Xcode 27.0 Build version 27A266a，swift --version输出Apple Swift version 6.4 (swiftlang-6.4.0.34.1 clang-2100.3.34.1)。⁴

Xcode 27的发布说明包含哪些内容？

这份说明是Apple开发者文档网站Xcode Release Notes之下的一个页面，篇幅很长：共有41个带标题的领域和296个列表条目，逐条数下来是134项新功能、134项已解决问题、19项已知问题和9项弃用。条目最多的是Instruments，有60条，其后依次是Device Hub 36条、Coding Intelligence 29条、Previews 27条、Previews & Playgrounds 18条、Testing 16条、Localization 15条。9项弃用分布在C++ Standard Library、Device Hub、devicectl、Instruments、Intel Deprecation、Linking、On Demand Resources、Previews和USDKit之下；其中会改变构建的是Linking和Intel的条目，下文各节引用了它们。这些数字是我在9月26日逐一清点各标题下的列表项得出的。²

与26.6相比，Xcode 27有哪些要求？

升级构建机器之前，该查的文档是Apple的兼容性表。两行并排如下：³

这几行背后藏着两个后果。Instruments现在拒绝早于iOS 17、watchOS 10或tvOS 17的设备，所以用一台旧iPhone搭起来的性能分析设备，会在任何App代码出问题之前先停摆。² 而Apple用一句话划定了Device Hub键盘和指针交互的支持范围：“only supported on the following OS versions and newer: macOS 15.0, iOS 18.0, tvOS 18.0, watchOS 11.0, visionOS 2.0.”（仅在以下及更新的系统版本上支持：macOS 15.0、iOS 18.0、tvOS 18.0、watchOS 11.0、visionOS 2.0）²

Apple silicon这项要求，对运行Xcode的那台Mac来说没有任何变通办法；7月读过Intel那篇文章的人对此早已不陌生。GA版说明完整保留了7月的措辞：“Xcode 27 will only install and run on Apple silicon Macs. The macOS 27 SDK supports back deploying Universal (Intel and Apple Silicon) apps to macOS 12 and later. Intel development is still possible with macOS versions that support Rosetta like macOS 27.”（Xcode 27只能安装并运行在Apple silicon Mac上。macOS 27 SDK支持将Universal（Intel和Apple Silicon）App向后部署到macOS 12及更高版本。在macOS 27这类支持Rosetta的macOS版本上，仍可进行面向Intel的开发）² 第三句给出的变通办法，是针对你要发布到的Mac，而不是你用来构建的Mac。

工具链变了什么？

链接器。 GA版说明一句话说完：”The ld64 linker has been removed and the -ld_classic option is no longer supported.”（ld64链接器已被移除，-ld_classic选项不再受支持）² 在27A266a上实际看到的情况是：工具链的usr/bin里只有一个链接器二进制文件ld，它自报为ld-27037.1，构建于2026年8月25日。传入旧标志并不会让链接失败。让hello.c只包含一行int main(void){return 0;}，运行clang hello.o -o hello_classic -Xlinker -ld_classic会打印ld: warning: -ld_classic is no longer supported and will be ignored，以退出码0结束并写出可执行文件。Apple在Xcode 15中写进文档的另一种写法-ld64就没这么走运了：⁸ clang hello.c -o hello_ld64 -Wl,-ld64以ld: library 'd64' not found失败，退出码为1，因为新链接器把-ld64读成了-l d64，也就是请求一个名为d64的库。⁴ 所以，在OTHER_LDFLAGS里保留-ld_classic的项目仍能构建，只是每次链接都多一条新警告，而它从旧链接器那里换来的任何行为都已消失；保留-ld64的项目则会链接失败，而且错误信息从头到尾不提链接器。我的ld64文章追查了这些标志的来源，并记录了两次运行。

默认架构。 Intel Deprecation一节陈述了规则：”Build targets with a min deployment target set to macOS 27.0 or DriverKit 27.0 will not build Universal by default. The ARCHS_STANDARD build setting will no longer include x86_64 when MACOSX_DEPLOYMENT_TARGET or DRIVERKIT_DEPLOYMENT_TARGET >= 27.0.”（最低部署目标设为macOS 27.0或DriverKit 27.0的构建目标，默认不再构建Universal版本。当MACOSX_DEPLOYMENT_TARGET或DRIVERKIT_DEPLOYMENT_TARGET大于等于27.0时，ARCHS_STANDARD构建设置将不再包含x86_64）² 我在一个多平台项目（Yawara，SUPPORTED_PLATFORMS = iphoneos iphonesimulator macosx xros xrsimulator）上用xcodebuild -showBuildSettings -sdk macosx复现了这一点；不带-sdk参数时，该项目根本不会解析出ARCHS_STANDARD，这个细节在Intel那篇文章中有说明。MACOSX_DEPLOYMENT_TARGET = 26.0时，该设置解析为ARCHS_STANDARD = arm64 x86_64；27.0时解析为ARCHS_STANDARD = arm64，而ARCHS_STANDARD_64_BIT在两种情况下都保持arm64 x86_64。⁴ 没有任何警告。如果你发布Universal版本并且要上调目标，请自己把x86_64加进ARCHS。

C++标准库。 “The minimum supported deployment target on macOS for the C++ standard library has been increased to 11.0,”（C++标准库在macOS上支持的最低部署目标已提高到11.0）说明在“Potentially breaking changes”之下列出了行为变化，第一条是multi{map,set}::find不再必然返回第一个匹配元素。² 新特性列表很长：std::chrono值的哈希、zip、std::optional<T&>、std::views::indices(n)等等。²

依赖扫描，以及可能让它失败的规则。 Apple称已对Swift依赖扫描器做了优化，“to avoid redundant setup work and header searches when looking up Clang modules during a single dependency-scan action”（以避免在单次依赖扫描操作中查找Clang模块时的冗余设置工作和头文件搜索），而这一提速附带一项要求：“every Clang module reachable from a single Swift dependency-scan action must have a unique module name. If two module maps visible to the same scan declare a Clang module with the same name, the scan may report an error. Previously, the scanner may have tolerated duplicating names.”（单次Swift依赖扫描操作可达的每个Clang模块都必须有唯一的模块名。如果同一次扫描可见的两个模块映射声明了同名的Clang模块，扫描可能会报告错误。此前的扫描器可能容忍了重名）² Apple点名了两种会触发它的形态：“projects or SDKs that vend the same Clang module name from more than one location on the header search path, and vendored third-party sources that ship a module.modulemap redeclaring an SDK module.”（在头文件搜索路径的多个位置提供同一Clang模块名的项目或SDK，以及内嵌的、自带一个重新声明SDK模块的module.modulemap的第三方源代码）² 和链接器移除一样，这条规则在工具链升级时触发，而不取决于部署目标；我的ld64文章把两个相互冲突的模块映射送进扫描器，编译了一个会遮蔽SDK模块的内嵌SQLite3垫片，并针对这两种形态审查了七个项目。在27A266a上，第一种形态报告的正是Apple那个“可能”所预期的错误：两份声明module Widget的模块映射放在同一条搜索路径上，会让swiftc -scan-dependencies在20次运行中20次打印error: redefinition of module 'Widget'，同时20次中20次以退出码0结束，并把该模块解析到第一个-I目录；7月时，Xcode 26.6对同一输入的20次运行有14次崩溃或中止。编译仍然会停下，因为-typecheck在20次中20次以同一错误失败。第二种形态，即一份重新声明SDK的SQLite3的内嵌模块映射，扫描时一切正常，stderr上没有任何输出，并且静默遮蔽了SDK的模块。⁴ 那篇ld64文章记录了在26.6和GA版上的两次运行。

什么会无法编译？

@State宏。 这项变化写在iOS 27的发布说明里，而不是Xcode的说明里，而且它取决于你用来构建的编译器，而不是你要部署的目标：”Xcode 27 introduces a new @State implementation that avoids this repeated evaluation. This new behavior back-deploys to iOS 17 aligned OSes. The new @State is implemented with a Swift macro. It is largely source compatible with the property wrapper version, with a few exceptions.”（Xcode 27引入了新的@State实现，避免了这种重复求值。新行为可向后部署到iOS 17同代的系统。新的@State用Swift宏实现，除少数例外，与属性包装器版本基本源代码兼容）⁶ Apple列出四个例外，其中两个给了代码清单，另外两个各只有一两句话：”In rare situations, the automatic inference of generic arguments of @State is less flexible with the macro implementation. Write the type with more specificity.”（在极少数情况下，@State泛型参数的自动推断在宏实现中不如以前灵活。请把类型写得更具体）以及”Composing @State with other property wrappers or macros is not supported.”（不支持将@State与其他属性包装器或宏组合使用）⁶ 会抓住现有代码的是带代码清单的那两个。其一是给一个已有声明处初始值的@State属性赋值的初始化器：SwiftUI一向会丢弃这个赋值，而现在“some such cases no longer compile.”（其中一些情况不再能编译）⁶ 其二是当所有存储成员都是private时编译器合成的私有逐成员初始化器：“The state macro disables this synthesized initializer. So the code above no longer compiles.”（state宏禁用了这个合成的初始化器，所以上面的代码不再能编译）⁶ 在27A266a上，第一个示例照原样就会失败，在给page赋值的那一行报error: variable 'self.title' used before being initialized，因为宏的setter在title存在之前就对self执行了；把self.title = title移到它上面，同一个文件就能编译，@State赋值照旧被丢弃。⁴⁶ 第二个示例，即在一个@State没有声明处初始值的结构体上，由扩展调用self.init(page: page, title: title)，在我的运行中原样通过了编译，宏展开也显示了让它得以通过的形态：宏在一个@storageRestrictions(initializes: _page)的init访问器背后生成了private var _page: SwiftUICore.State<StickerPage>，正是这个构造让逐成员初始化器可以接受page:。⁴ 请把这份说明当作需要检查的形态清单来读，然后在自己的代码上逐一确认。@State宏文章统计了四个已上架App中这两种模式的出现次数；那篇文章是7月根据beta版说明写的，早于这次GA测试，它留下的悬而未决的问题也在这里画上句号：在初始化器内直接给后备存储赋值，即_page = State(initialValue:)，无论有没有声明处初始值，在27A266a上都能编译。⁴

SE-0508造成的破坏。 Swift Compiler的Known Issues写道：”A computed property with both an init accessor and an array/dictionary literal initial value will no longer compile if the getter is declared before the init accessor.”（同时带有init访问器和数组或字典字面量初始值的计算属性，如果getter声明在init访问器之前，将不再能编译）随后是一段代码清单，然后是归因：”This is a known source break from SE-0508.”（这是SE-0508造成的已知源代码兼容性破坏）变通方法全文如下：”Swap the init accessor and the getter such that the init accessor is declared first.”（交换init访问器和getter的位置，使init访问器先声明）² SE-0508是”Array expression trailing closures”（数组表达式尾随闭包），在Swift 6.4中实现，提案恰好预见了这种情况：”If the getter is declared before the init accessor, we will now attempt to parse as a trailing closure,”（如果getter声明在init访问器之前，我们现在会尝试将其解析为尾随闭包）并补充说”init accessors are however considered for disambiguation, so swapping the accessors is sufficient to make this valid regardless of initial value used,”（不过init访问器会被纳入消歧考虑，因此无论使用何种初始值，交换访问器的顺序就足以使其合法），还说这种情况“does not appear in the source compatibility suite, or for internal Swift projects at Apple.”（未出现在源代码兼容性测试套件中，也未出现在Apple内部的Swift项目中）⁷ 用一个九行的结构体就能复现。getter在前时，swiftc在访问器那一行以error: initializers may only be declared within a type失败；把@storageRestrictions(initializes:)的init访问器移到get上面，同一个文件就能编译。⁴

struct Container {
    private var storage: [Int] = []
    var items: [Int] = [] {
        @storageRestrictions(initializes: storage)
        init(initialValue) { storage = initialValue }   // 必须位于get之前
        get { storage }
        set { storage = newValue }
    }
}

PreviewProvider。 Previews一节列出了一项弃用：”PreviewProvider and its family of preview modifiers.”（PreviewProvider及其一族预览修饰符）² SDK也带上了这项弃用，协议有一条消息，每个修饰符各有一条不同的消息。在iOS 27 SDK的SwiftUI接口中，public protocol PreviewProvider位于@available(anyAppleOS, deprecated: 27.0, message: "Use #Preview instead.")之下；previewLayout的消息是“Use #Preview(traits: .sizeThatFitsLayout) or .fixedLayout(width:height:) instead.”；previewDisplayName是“Use #Preview(‘name’) instead.”；previewInterfaceOrientation是“Use #Preview(traits: .landscapeLeft) or other orientation traits instead.”；previewDevice是“Use the device picker in Xcode’s canvas.”（请使用Xcode画布中的设备选择器）；previewContext连同PreviewContext和PreviewContextKey协议则是“Use #Preview with a Widget timeline provider or entries instead.”（请改用带有Widget时间线提供者或条目的#Preview）⁴ 你到底会不会看到这些消息，由两个事实决定。编译器会把弃用版本与部署目标比较，所以修饰符只在最低版本为27.0的目标中警告：一个使用了previewLayout、previewDisplayName和previewDevice的文件，在-target arm64-apple-ios27.0-simulator下产生三条警告，在17.0或26.0下一条也没有。而PreviewProvider本身永远不会警告，原因另有所在。SDK在anyAppleOS弃用标记的正上方用@available(iOS 13.0, macOS 10.15, tvOS 13.0, watchOS 6.0, *)声明了它，在我的探测中，带有这一对属性的协议在27.0目标下，无论是遵循它还是把它用作参数类型都不会警告；而同一个协议若只用@available(iOS, deprecated: 27.0)弃用，或只用anyAppleOS形式弃用，两种用法都会警告。修饰符自身的声明只带anyAppleOS弃用标记（容纳它们的extension SwiftUICore.View带有introduced属性，而这种继承而来的形式并不会抑制警告），这就是修饰符会警告而协议不会的原因。⁴ 在任何实际发布的部署目标下，构建日志两种情况都是静默的，所以请搜索PreviewProvider和这些修饰符并迁移到#Preview，画布现在通过新的#Preview(arguments:)语法按参数以网格形式渲染。²⁴

System的新stat()。 System库现在为stat、lstat、fstat和fstatat提供Swift API，带有Stat类型和FilePath.stat()实例方法。² 说明将一个冲突列为已修复：一个调用未限定stat()的扩展与新方法发生了冲突；如果你在那个冲突还存在时加上了Darwin.限定，可以保留。²

Address Sanitizer，方向相反。 “Address Sanitizer might fail to launch on iOS 27.0, tvOS 27.0, watchOS 27.0, and visionOS 27.0 when building with Xcode 26.4 or older.”（使用Xcode 26.4或更早版本构建时，Address Sanitizer可能无法在iOS 27.0、tvOS 27.0、watchOS 27.0和visionOS 27.0上启动）变通方法是使用Xcode 26.5或更高版本，这对那些CI机器上仍保留旧版Xcode、而设备已更新到27.0的团队很重要。²

IDE和工具变了什么？

• Interface Builder无需模拟器即可构建。 新的编译模式toolchain，”for UIKit (Cocoa Touch) based documents. Enabled by default, toolchain allows compiling IB documents without the need to download a simulator, which is especially useful for build servers.”（面向基于UIKit（Cocoa Touch）的文档。默认启用的toolchain允许在无需下载模拟器的情况下编译IB文档，这对构建服务器尤其有用）²
• 模拟器启动更快，还能重启。 “The simulator runtimes now contain a pre-built dyld cache. This will make first launch of a simulator much faster,”（模拟器运行时现在包含预构建的dyld缓存，这会让模拟器的首次启动快得多）simctl新增了reboot命令。² 一个已知问题仍然存在，用Apple的原话说：“Some simulator runtimes are not completely deleted when removed, re-appearing after a reboot.”（某些模拟器运行时在移除后没有被完全删除，重启后会再次出现）²
• devicectl的JSON升到第5版。 xcrun devicectl --version报告642.16，list devices --json-output写出"jsonVersion": 5；Apple弃用了hardwareProperties、deviceProperties和connectionProperties字段，改用一个properties字典，仍包含这些字段的结果会附带_deprecationNotice。²⁴
• StoreKit测试。 StoreKit配置界面可以定义优惠代码，可以为本地测试配置订阅包，Transaction Manager可以在不连设备的情况下演练带优惠代码的购买。²
• Organizer。 Insights Overview“summarizes high-impact performance regressions”（汇总影响重大的性能回退），Hitches指标取代了Scrolling指标。²
• 编码助手。 Google Gemini加入了模型列表，“Planning with agents is now first class in Xcode,”（与代理一起做规划如今是Xcode的一等功能）计划是可编辑的Markdown产物，你先批准，代理再继续；我的编码代理文章介绍了beta版时的工作流，GA版说明中列出了专门用于这些产物的Markdown编辑器。²
• 本地化。 代理可以翻译String Catalog条目，导出本地化内容时现在会从头文件中提取NSLocalizedString及类似的宏。²
• Icon Composer。 说明称之为Icon Composer 2.0，“a new sharper rendering mode for upcoming 2027 operating systems”（面向即将到来的2027年操作系统的更清晰的新渲染模式）；27A266a内置的包报告版本号为27.0。²⁴
• 测试。 测试计划可以设置UI测试期间目标App崩溃时Xcode的处理方式，从关闭到致命失败；swift test新增了--maximum-repetitions和--repeat-until [pass|fail]，并在结尾给出失败摘要。²
• 调试。 在使用桥接头文件时，LLDB“can now directly import explicitly built Swift modules and PCH from DerivedData,”（现在可以直接从DerivedData导入显式构建的Swift模块和PCH）language swift task tree命令可列出Swift并发任务。²

这周我会做什么

1. 动CI之前先读兼容性表的那几行：构建用Mac装macOS 26.6、仅限Apple silicon、最老的测试设备为iOS 17，以及macOS 12、watchOS 9或DriverKit 21中适用于你产品的那一项。²³
2. 用grep找出-ld_classic和-ld64并把两者都删掉；前者链接器每次链接都会带警告地忽略，后者会直接失败。既然已经在构建设置里，顺便找找手写的、重新声明了SDK模块的module.modulemap文件，也就是Apple在唯一模块名规则中点名的那种形态。²⁴
3. 如果你把任何macOS或DriverKit目标设为27.0并且要发布Intel版本，请显式设置ARCHS；只靠ARCHS_STANDARD得到的是arm64，这一点我在macOS上复现了，Apple则对两者都有明确说明。²⁴
4. 搜索PreviewProvider、previewLayout、previewDisplayName和previewDevice，按各自注解的消息迁移：协议迁移到#Preview，previewLayout迁移到#Preview(traits: .sizeThatFitsLayout)或.fixedLayout(width:height:)，previewDisplayName迁移到#Preview("name")，previewDevice迁移到画布中的设备选择器。修饰符只在27.0部署目标下警告，而PreviewProvider遵循在任何目标下都不警告，所以实际发布目标的构建日志会一直保持安静。⁴
5. 用Xcode 27构建一次，留意两条诊断：一条是variable 'self.title' used before being initialized，出现在一个在其他存储属性之前给已有声明处初始值的@State属性赋值的初始化器上，@State宏文章对此有逐步讲解；另一条是initializers may only be declared within a type，出现在带有数组或字典字面量初始值和init访问器的属性上，把访问器移到getter上面即可。²⁴⁶
6. 趁App Store Connect已开始接受27系SDK，上传一个TestFlight版本，并记住启动画面规则和UIKit场景生命周期强制要求，因为App一旦链接到27，这两条就都会生效。⁵⁶

常见问题

Xcode 27是什么时候发布的？

2026年9月14日星期一，构建版本27A266a，与iOS 27.0、iPadOS 27.0、macOS 27.0、tvOS 27.0、visionOS 27.0和watchOS 27.0同一天；信息源将其iOS 27.0 RC（24A437）条目标注为9月11日，即App Store Connect开始接受RC SDK构建版本两天之后。¹⁵

Xcode 27需要什么版本的macOS？

Apple silicon Mac上的macOS Tahoe 26.6或更高版本。它无法在Intel Mac上安装或运行。它可以在同日发布的macOS 27.0上运行。²³

Xcode 27的最低部署目标是多少？

iOS 15、iPadOS 15、tvOS 15、watchOS 9、visionOS 1、macOS 12和DriverKit 21。与Xcode 26.6相比，watchOS从8上调，macOS从11上调，DriverKit从20上调。³

Xcode 27还能构建Universal版Mac App吗？

能，可以向后支持到macOS 12，但一旦目标的MACOSX_DEPLOYMENT_TARGET为27.0，默认就不会了：此时ARCHS_STANDARD只解析为arm64，你需要自己把x86_64加进ARCHS。²⁴

Xcode 27.1发布了吗？

截至2026年9月15日尚未发布。Apple的Releases信息源和Xcode发布说明索引都只列出了Xcode 27，Apple的iPhone Duo开发者页面仍把Xcode 27.1 beta标注为“Coming later this month”（本月晚些时候推出）；iPhone Duo SDK不在本次发布之列。¹（9月17日：仍然没有27.1。Xcode 27.2 beta（27B5019j）已于9月16日发布，其发布说明称，面向iPhone Duo的iOS SDK和模拟器支持“will be available later this month in an upcoming release of Xcode 27.1.”（将于本月晚些时候随即将发布的Xcode 27.1提供）⁹）（9月19日：作为beta，是的。Xcode 27.1 beta（27A9269）于9月18日发布，附带iOS 27.1 SDK以及27.2 beta发布说明所说的“simulator support for iPhone Duo,”（iPhone Duo的模拟器支持），App Store Connect接受其构建用于TestFlight；27.1正式版尚未发布，Apple 9月16日的新闻称iPhone Duo在10月23日上市时“will run iOS 27.1”（将运行iOS 27.1）。¹⁰）（10月1日：仍然只有第一个27.1 beta，即27A9269。¹¹）（10月11日：作为RC，是的。Xcode 27.1 RC（27A9275）已于10月5日发布，附带Swift 6.4和iOS 27.1 SDK，App Store Connect接受用它构建的版本上架App Store；Releases信息源尚未列出Xcode 27.1正式版。¹²）（10月14日：仍是RC；Xcode 27.2 beta 3于当天发布，但没有一同推出Xcode 27.1正式版。¹³）（10月15日：作为正式版，是的。沿用RC构建的Xcode 27.1（27A9275）在Apple的Releases信息源中的日期为太平洋时间13:00；发布说明页面改名为“Xcode 27.1 Release Notes”，App Store Connect当天的条目写道：“You can now upload apps built with Xcode 27.1 using the SDK for iOS 27.1, iPadOS 27.0, macOS 27.0, tvOS 27.0, visionOS 27.0, and watchOS 27.0 for the App Store, and for internal and external testing through TestFlight.”（现在可以上传用 Xcode 27.1、以 iOS 27.1、iPadOS 27.0、macOS 27.0、tvOS 27.0、visionOS 27.0 和 watchOS 27.0 SDK 构建的应用，用于 App Store，以及通过 TestFlight 进行的内部和外部测试）¹⁴）

Xcode 27的发布说明在哪里？

在Apple开发者文档网站的Xcode Release Notes之下，本次发布对应一个页面；本文引用的章节有Overview、Linking、Intel Deprecation、Previews、Swift Compiler、Address Sanitizer、Instruments、Device Hub、devicectl、Simulator、Interface Builder、C++ Standard Library、Organizer、Coding Intelligence、Source Editor、Icon Composer、StoreKit Testing in Xcode、Localization、Testing、Swift Package Manager、Debugging和System，以及自9月17日更新起的Enhanced Security。²⁹ @State宏的变化则在iOS和iPadOS 27发布说明的SwiftUI部分。⁶

参考来源