很多iOS开发者第一次遇到“Xcode调试时搜索不到iOS模拟器”这个问题时，第一反应都是怀疑自己是不是把Xcode弄坏了。尤其是照着教程走，到了选设备那一列，发现上面空空如也，只有一个“Other”选项，或者是明明项目支持模拟器，却提示“No devices available”或者“No run destinations”。这种时候确实很劝退，但说实话，这个问题的原因通常并不复杂，八成是工具链层面的小毛病，跟你的代码关系不大。这篇文章我会把常见的触发原因、排查顺序、实操解决步骤以及一些容易被忽略的经验全部整理出来，帮你在最短时间内定位并解决问题。
先说一下这个问题是什么：你在Xcode顶部的设备选择栏（就是那个写着项目名称和运行目标的地方）点击之后，找不到任何iOS Simulator。你需要知道，Xcode想在这个列表里显示模拟器，需要满足几个前提——模拟器运行时（Simulator Runtime）已经安装、CoreSimulator服务能正常工作、当前项目支持的平台和模拟器匹配。任何一环出了问题，表现出来基本都是“搜索不到模拟器”。这篇文章适合所有用Xcode 12到最新版、甚至是从旧项目迁移过来的新老开发者，尤其是刚接触iOS开发、习惯照着视频一步步操作的新手，大概率会遇到这种问题。
1. 先搞清楚：是“没有模拟器”还是“选不中模拟器”
1.1 建立基础认知：Xcode 的模拟器机制
在动手排查前，我想先给你建立一个基本的认知框架。Xcode 里的“iOS 模拟器”不是一个简单的“窗口”，它由几层东西组成：
- 模拟器 App本身（就是你在 Launchpad 里看到的那个“Simulator”图标对应的应用，路径在 Xcode 内部），负责显示渲染界面、模拟交互。
- 模拟器运行时（iOS Simulator Runtime），类似一个“系统镜像”，每个 iOS 大版本都有对应的 Runtime。比如 iOS 16.4 Simulator Runtime、iOS 17.2 Simulator Runtime。
- CoreSimulator 后台服务，负责协调模拟器的生命周期、设备注册和与 Xcode 的通信。你可以把它理解成一个“管家”，Xcode 需要它来发现当前装了哪些设备、哪些运行时、哪些设备正在运行。
这三者缺一不可。所以当你发现搜索不到模拟器时，第一步不是急着敲命令，而是先判断：是设备注册表里根本没设备？是有设备但无法启动？还是有设备能启动但 Xcode 识别不了？用生活化的类比来说，Xcode 相当于一个导演，模拟器是演员，CoreSimulator 是经纪人。导演找不到演员，不代表演员不存在，可能是经纪人没报备，可能是演员档期（Runtime）不对，也可能是导演看错了片场（项目配置）。
提示：这里的“设备”和“运行时”是两层概念。一个设备（比如 iPhone 15 Pro）必须绑定一个 iOS 版本运行时，才能在列表中出现。如果你只装了设备定义，但没下载对应的 Runtime，它同样不会显示。
1.2 快速判断你属于哪种情况
我这里给一个快速判断方法。打开 Xcode 后，不加载项目，直接看菜单栏的 “Window” -> “Devices and Simulators”。切到 “Simulators” 标签页。如果你在左侧列表里能看到 iPhone、iPad 等设备，说明“经纪人有报备”。如果左侧是空的，说明设备定义都没了，问题出在 CoreSimulator 的设备注册层面。
如果你在这里能看到设备，但点选某个设备时提示“OS版本不支持”或者旁边显示警告图标，那说明设备没问题，但对应的 Runtime 没装或者损坏。如果你这里一切正常，设备也在，Runtime 也在，但回到项目界面依然找不到模拟器，那问题多半出在 Xcode 的工程配置（比如 Deployment Target 或 Supported Destinations）上。
另外一个很重要的排查工具是终端命令。打开终端，输入下面这段代码，能列出 Xcode 当前能够识别的所有模拟器设备：
xcrun simctl list devices注意看输出结果尾部有没有 “(Shutdown)”、“(Booted)” 这样的状态。如果你看到的列表里只有 “-- iOS 17.4 --” 这样的标题，但下面一行设备名都没有，那说明系统里有 Runtime，但设备定义丢了，这在升级 Xcode 或者迁移系统时比较容易碰到。
2. 最常见的“坑”：工程配置与部署目标不匹配
2.1 Deployment Target 比模拟器系统版本还高
这是很多新手最容易踩的坑，而且不容易意识到。Xcode 项目里有一个参数叫 “Deployment Target”（部署目标），它决定你的 App 最低能跑在哪个版本的 iOS 上。如果你的 Deployment Target 设置为 17.4，但你设备列表里的模拟器最高只装了 iOS 17.0 的 Runtime，那这个模拟器就不会出现在运行目标里。Xcode 的逻辑是：一个 App 的最低系统要求，不能高于当前设备的系统版本，否则它无法保证 App 在该设备上正常运行。
实际操作中怎么查呢？选中项目文件（蓝色图标），找到 “Build Settings” 或 “General” 标签页，找到 “iOS Deployment Target”。把它改成比你模拟器系统版本低的值，比如 16.0 或 15.0。这一步看似简单，但确实能一次性解决大量“搜索不到模拟器”的问题。需要注意的是，在一些大型项目中，可能不止一处设置这个值。比如测试 Target 和主 Target 的 Deployment Target 不一致，也可能导致运行目的地列表里什么都不显示。
注意：除了主工程，你还需要检查 Pods 项目（如果你用 CocoaPods）里的相关 Target。有时候主工程设置没问题，但某个 Pod 库的 iOS 版本要求过高，也会导致 Xcode 认为当前没有可用的运行目的地。遇到这种情况，通常 Pods 的 Deployment Target 会自动跟随主工程，但手动改过就容易出岔子。
2.2 项目里只配置了真机调试环境
还有一类情况，是项目里压根没加入模拟器架构的支持。多见于从别人那里下载的源码、或者是很久以前的旧工程。在 Xcode 的 “Build Settings” 中，有一个关键参数叫做“Supported Platforms”，正常情况下应该包含iOS。如果被改成了iOS但依然找不到模拟器，再检查“Build Active Architecture Only”和“Excluded Architectures”。
排查步骤总结如下：
- 打开 “Build Settings”，搜索 “Supported Platforms”，确认值包含
iOS。 - 搜索 “Architectures”，确认 Debug 模式下 arm64 和 x86_64 没有被排除。
- 如果你用的 Mac 是 Apple Silicon 芯片（M1/M2/M3），那模拟器跑的是 arm64 架构的原生程序，和真机的 arm64 其实不同。不要因为在 “Excluded Architectures” 里排除了某个架构导致模拟器目标不可用。
如果你用真机调试过项目，Xcode 可能会在配置里生成新的配置，比如把 “Destination” 锁定为 Generic iOS Device。这种情况尤其容易在 .xcscheme（Scheme 文件）里体现。你看看左上角选择设备的地方，有没有类似 “Generic iOS Device” 的选项但点开没有模拟器？如果有，检查一下 Scheme 的 Run 配置里，是否在 “Run” -> “Info” -> “Executable” 选项中误选成了某个 .app 文件，这会导致系统认为你只能跑真机。
实操建议：最稳妥的办法是删掉项目里的 DerivedData 缓存。路径一般在
~/Library/Developer/Xcode/DerivedData。删的时候记得先退出 Xcode，然后重新打开项目，让 Xcode 重新索引并构建设置。我见过有不少人项目配置明明没问题，就是 DerivedData 里的本地缓存和当前模拟器状态不一致，导致一直寻不到设备。
2.3 Rosetta 模式带来的误解
接着上面架构的话题说。如果你用的是 Apple Silicon Mac，你可能会在 Finder 里看到 Xcode 的 “显示简介” 面板，里面有一个“使用 Rosetta 打开”的选项。这个选项主要是为了兼容那些还没有适配 Apple Silicon 的插件或工具链。但你需要注意，一旦你用 Rosetta 模式打开 Xcode，部分模拟器运行时（尤其是新版 iOS 的模拟器运行时）可能无法正常工作，因为模拟器本身已经原生支持 arm64，不需要转译。这种模式下，设备列表偶尔会显示不全，或者某些模拟器能启动但 Xcode 里就是枚举不到。
如果你之前不小心勾选了 Rosetta，别犹豫，取消勾选，重启 Xcode。这一点我在社区的帖子里见过好多次，尤其是从 Intel Mac 换到 Apple Silicon 的用户，因为之前的习惯或者某个组件的要求，就默认勾上了 Rosetta。但 Xcode 本身是原生支持新架构的，多数情况下不需要这个兼容层。
3. 一步步实操：从简单到暴力解决
3.1 第一步：让 Xcode 重新扫描模拟器
开始动手之前，先养成一个习惯——先让 Xcode 重新扫描一遍模拟器。有时候它只是“短暂失忆”了。具体操作是：
- 彻底退出 Xcode（按 Cmd+Q，不要直接关窗口）。
- 打开“活动监视器”，搜索
Xcode以及Simulator，确保后台没有残留进程。 - 打开终端，执行下面这条命令，把 CoreSimulator 服务先停掉再启动：
sudo launchctl remove com.apple.CoreSimulator.CoreSimulatorService 2>/dev/null; open -a Simulator这条命令会先尝试移除 CoreSimulator 服务进程，然后打开模拟器 App。正常的话，你会在 Dock 上看到模拟器启动，然后设备列表里会出现默认的设备。这一步能解决大约三成的“搜索不到模拟器”问题，因为 CoreSimulator 服务卡死或崩溃是常见现象，尤其是在 Mac 睡眠唤醒后或者系统更新后。
如果上面这条命令执行后没有任何反应，或者提示服务不存在，也别慌。可以直接重启 Mac，有时候 CoreSimulator 服务与 launchd 之间的状态没同步，重启是最省心的重置手段。
3.2 第二步：检查并安装/更新模拟器运行时
如果模拟器 App 能正常打开，但 Xcode 里的运行目的地列表依然没有模拟器，那么大概率是运行时缺失。你可以通过两种方式处理。
第一种，通过 Xcode 图形界面。打开 Xcode，进入Settings（快捷键Cmd+,），选择 “Components” 标签页。在 “Simulator Runtime” 一节，你会看到一系列可选的 iOS 版本运行时。如果你之前没下载过，列表里只会显示当前 Xcode 带的那一个，甚至一个都没有。找到你需要的版本，点击下载图标。下载完成之后，重新启动 Xcode，再检查设备列表。
第二种，通过命令行，适合想要精确控制版本的场景。使用xcodebuild命令查看当前 Xcode 支持的 SDK 列表：
xcodebuild -showsdks看到类似iphonesimulatorXX.X（XX 是你的系统版本）就说明模拟器的 SDK 已经存在。如果你想快速安装某个特定的运行时，也可以使用xcodebuild -downloadPlatform iOS来触发系统级的下载流程，不过这个命令会下载最新版的模拟器运行时，不能选具体版本，所以我还是建议大部分用户直接走图形界面。
实操心得：如果你电脑上 Xcode 是 14.2 或 15.x，但你下载的是 iOS 17 的模拟器运行时，需要注意版本匹配问题。Xcode 15 一般对应 iOS 17 的模拟器运行时，Xcode 14 对应 iOS 16，跨大版本有时候虽然能用，但容易遇到模拟器启动白屏或性能异常。最好的方式是 Xcode 版本和主版本 runtime 保持一致，比如 Xcode 15.x 就老老实实用 iOS 17 系的模拟器。
3.3 第三步：删除损坏的设备文件
如果运行时都是完好的，设备列表里还是空空如也，可以尝试删掉模拟器设备文件，重新创建。这里的原理是：模拟器的“设备定义”存在本地数据库中，有时候数据库会出现损坏或状态错乱，导致 Xcode 显示不出设备。这一步损失不大，因为你创建的那些模拟器里的 App 数据会清空，但本地的源码工程不会受影响。
操作路径分两个层面。
首先是图形界面层面。打开 “Devices and Simulators” 窗口，切到 “Simulators” 标签，如果左侧能看到部分设备，右键点击设备选择 “Delete”，然后点击左下角的 "+" 号，选择 “Create a new simulator”，从 Device Type 里选择 iPhone 15 之类，再从 “OS Version” 下拉框里选择你下载过的 runtime，点击 “Create”。如果左侧是空的，连设备都没有，那你得先确认 Runtime 安装了没有，确认后再新建。
其次是命令行层面，适用于图形界面操作失败的情况。执行下面两条命令：
xcrun simctl delete all xcrun simctl runtime list第一条会删除所有模拟器设备。第二条会列出当前所有已安装的运行时。你可以对比一下，看看是不是真的没有已安装的 runtime。如果 runtime 存在，你再手动创建新的设备：
xcrun simctl create "My iPhone" com.apple.CoreSimulator.SimDeviceType.iPhone-15 xcrun simctl create "My iPhone" "com.apple.CoreSimulator.SimDeviceType.iPhone-15" "com.apple.CoreSimulator.SimRuntime.iOS-17-4"注意第二条命令中的 ”com.apple.CoreSimulator.SimRuntime.iOS-17-4“ 需要根据你实际的 runtime 标识来填，具体的标识符可以通过xcrun simctl runtime list查看。
注意：这里需要提醒的是，模拟器的设备名称和 DeviceType 标识符不一定完全一样。在终端里执行
xcrun simctl devicetypes list可以查看所有可用类型，找到类似com.apple.CoreSimulator.SimDeviceType.iPhone-15的合法值，复制的时候不要带尾部的括号内容。
3.4 第四步：重置模拟器 App 的本地状态
还有一种比较隐蔽的情况，模拟器 App 本身虽然能启动，但窗口一直显示的是黑屏或者卡在启动界面，这时候你在 Xcode 里搜索模拟器，往往也会搜不到。原因可能出在模拟器 App的缓存上。你可以这样重置：
- 确保模拟器是关机状态。
- 在终端执行
xcrun simctl shutdown all，把所有模拟器关机。 - 然后回到 “设备与模拟器” 窗口里，右键对应的模拟器，选择 “Erase All Content and Settings”。这个操作会重置模拟器内部的系统状态，清掉所有安装的 App 和数据，但对模拟器运行时本身没有影响。
- 重新启动模拟器，等它完全开机后，再在 Xcode 里选择它作为运行目的地。
如果模拟器没有办法关机或响应，直接先杀掉 Simulator 进程再执行命令也行：
killall Simulator xcrun simctl shutdown all这一步我把它归类于“抹平一切不安定因素”。很多时候模拟器里面跑过一些测试或者崩溃过的进程，残留的状态会影响 Xcode 的判断，但表面上看不出什么问题。重置之后往往就恢复了。
4. 进阶处理：Apple Silicon Mac 的 Rosetta 与多版本 Xcode
4.1 多版本 Xcode 并存导致的 CoreSimulator 冲突
装多个 Xcode 版本（比如 Xcode 14 和 Xcode 15 共存）的用户，偶尔会遇到模拟器列表空白的情况。原因通常是两个版本的 Xcode 共用同一个 CoreSimulator 服务，而不同版本的 CoreSimulator 对设备管理的方法有差异。比如你用旧版 Xcode 创建了设备，然后新版 Xcode 打开时，旧设备的数据库格式不被新版识别，或者反过来。这种情况下，不管你怎么查 Runtime，都会发现问题不在设备本身，而在服务层面。
一个相对靠谱的解法是：让其中一个版本的 Xcode 使用独立的 Developer Dir。开发者目录（Developer Dir）是 Xcode 与系统工具链交互的地方，可以通过以下命令切换：
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer如果你装了多个 Xcode，也可以用xcode-select -print-path查看当前生效的路径，再切换到你最常用的那个 Xcode。切换完之后，重启模拟器服务：
sudo launchctl remove com.apple.CoreSimulator.CoreSimulatorService sudo launchctl list | grep CoreSimulator如果没有输出，说明服务已经被移除，再打开 Xcode 后它会自动重新创建。这套组合拳我试过很多次，基本能解决多 Xcode 并存带来的模拟器识别问题。
4.2 老项目升级后搜索不到模拟器的特殊处理
有的读者可能会遇到这种情况：原来项目在旧电脑上是用 Xcode 12 跑的，现在搬到新电脑上，装的是 Xcode 15，打开老项目发现找不到模拟器。这种时候，首先要排除 Deployment Target 过低的问题。虽然理论上 iOS 15.0 的 Deployment Target 在上面的模拟器上应该能跑，但如果模拟器运行时只装了 iOS 17.4，而项目的某处配置里写死了仅支持某个特定版本，仍需注意。
另外，有些老项目会使用“Legacy Build System”（旧版构建系统），这套构建系统对新的模拟器运行时支持并不好。在 Xcode 的 “File” -> “Project Settings” 里，有一个 “Build System” 的选项，如果显示的是 “Legacy Build System”，建议先改成 “New Build System (Default)”。这更像是“拆掉旧水管换新水管”，改完之后 Xcode 与模拟器的配合会顺畅很多。
个人经验：我维护的一个老项目，从 Xcode 11 时代一直传到今天，中间因为构建系统版本太旧，也出现过模拟器列表空白的问题。后来发现是项目里的 “User-Defined” 设置中存在一个叫
SDKROOT的变量，它锁死了 iphoneos 版本，导致模拟器 SDK 一直匹配不上。如果你也折腾半天找不到原因，可以在 Build Settings 里搜索 “SDKROOT” 或 “SUPPORTED_PLATFORMS”，看看有没有异常的覆盖值。
5. 一些容易被忽略的“隐藏因素”和操作盲区
5.1 模拟器窗口明明开着，但 Xcode 找不到
还有一种情况比较迷惑：模拟器 App 已经启动，窗口也显示出来了，但 Xcode 的设备列表里依然找不到刚启动的这台设备。这种现象通常发生在“选手动打开模拟器”的场景。你从 Launchpad 或 Dock 上直接点开了模拟器 App，它默认启动了“上次使用的那台模拟器”，但 Xcode 有时候没法反向枚举到这台设备的运行状态。
如果你遇到这种情况，解决办法是：不要在 Xcode 外面手动打开模拟器，而是直接在 Xcode 界面里通过左上角的设备菜单选择打开。或者，如果已经打开了，就在终端里执行xcrun simctl list devices | grep Booted，看看哪台设备处于 Booted 状态，如果能查到，再在 Xcode 里手动将这个模拟器设置为运行目的地。大多数情况下，这一步只是刷新不够及时的问题，循环切换一下设备菜单就能解决。
5.2 重置“模拟器菜单”的隐藏技巧
这里还有一个很少人知道的小技巧，就是你可以直接按住 Option 键点击 Xcode 左上角的运行目的地菜单，它会显示更多的隐藏选项（比如 “Manage Run Destinations…”）。如果模拟器列表因为某些原因显示不全，这个操作能强制 Xcode 重新加载运行目的地的列表。等同于你告诉 Xcode：“赶紧重新检查一遍”。
类似的，在终端里执行下面代码，会强制让 Xcode 重新读取模拟器相关的偏好设置：
defaults delete com.apple.dt.Xcode DVTDeviceManagerList执行完重启 Xcode，这个命令会清除 Xcode 内部的设备管理器列表缓存，是一种比较 subtle 但有效的“轻量重置”。
5.3 模拟器界面语言设置造成的误解
如果模拟器能启动，但你在设备列表里看不到 iPhone 设备，只能看到 Apple TV 或 Watch 之类的，这可能是和运行时版本有关系。模拟器的设备列表是会按“设备类型”分组的，在Devices and Simulators窗口里，左侧的列表最下方有一个 “Show Expired” 选项，如果勾上了会出现很多过期的模拟器。但更关键的是，要看你的窗口右侧是不是选了 “iOS” 还是 “tvOS”。有时候你之前浏览过 Apple TV 模拟器，切到该项目的时候它会停留在原来的筛选条件，看起来就像 iOS 模拟器消失了。这个属于操作盲区，无脑重置窗口状态最简单：直接关闭弹窗，重新在菜单栏点 “Window” -> “Devices and Simulators”。
实操中我发现一个认知误区：很多人认为模拟器列表是“自动扫描”的，但其实它更像“根据当前启用的平台和配置生成”。当你这个项目只支持 iOS 平台，它不会显示 watchOS 模拟器；当你项目的 Deployment Target 设置得奇高，它可能连普通 iOS 模拟器都不显示。理解了这一点，排查逻辑就清晰很多。
6. 常见问题与排查技巧实录（速查表）
为了方便你在报错现场快速对照，我整理了一个速查表，覆盖掉我这两年零零散散遇到的各种情况。
| 现象 | 原因方向 | 快速解法 |
|---|---|---|
| 模拟器列表完全为空 | CoreSimulator 服务异常或设备定义丢失 | 执行xcrun simctl list devices确认设备；执行sudo launchctl remove com.apple.CoreSimulator.CoreSimulatorService重置服务 |
| 有设备但系统版本损坏 | 模拟器运行时下载不完整 | 在 Xcode 设置 Components 里删除该 runtime，重新下载；或xcrun simctl runtime list校验 |
| 只显示真机，不显示模拟器 | 工程配置的 Supported Platforms 异常 | 检查 Build Settings 里的SUPPORTED_PLATFORMS和SDKROOT是否有覆盖值 |
| 模拟器能启动但 Xcode 不显示 | 设备管理列表缓存出错 | defaults delete com.apple.dt.Xcode DVTDeviceManagerList，重启 Xcode |
| 模拟器闪退或启动黑屏 | 模拟器内部状态崩溃 | xcrun simctl shutdown all，在设备列表里对对应模拟器执行 Erase All Content and Settings |
| 老项目打开后没有模拟器 | Legacy Build System 或陈旧配置覆盖 | 项目设置改回 New Build System；检查 User-Defined 变量是否锁死 SDK |
实操心得补充
再分享几个容易让你绕远路的点：
升级 Xcode 之后最好重启一次电脑。Xcode 的安装、升级涉及很多系统级服务的更新，例如 CoreSimulator 的升级往往需要替换 LaunchDaemon 中的相关文件。如果你不重启，旧的进程可能依然常驻内存，导致新的服务和旧进程冲突。我试过在升级 Xcode 后模拟器怎么都搜不到，重启一次就好。
不要在运行项目的时候删除模拟器。在 App 正在运行时，如果你去
Devices and Simulators里把当前正在 Booted 状态的模拟器删除，会造成设备注册表错乱。万一你不小心这么干了，别担心，xcrun simctl delete all然后重新创建就行。善用
xcrun simctl命令，它比图形界面更可靠。经常用图形界面刷新设备时遇到状态同步问题，但命令行是直接和 CoreSimulator 服务交互的，反馈更真实。比如你可以用xcrun simctl boot "iPhone 15"直接指定启动某台设备，再在 Xcode 里刷新，往往比在图形界面里点击更有效。注意 Xcode 的 DerivedData 缓存。这个在东尼吐槽过很多次，但还是有一堆人忽视。路径
~/Library/Developer/Xcode/DerivedData下对应工程的缓存会记录上一次的构建情况和设备信息。如果缓存里的构建配置和现在系统的模拟器环境不一致，也会出现找不到模拟器的问题。删除工程对应的缓存文件夹，重新打开项目，让它全量重新索引，绝对值得一试。模拟器运行时下载失败怎么办。如果你在 Xcode 界面下载模拟器时一直卡住或下载超时，可以尝试自己到 Apple 开发者官网下载 dmg 格式的运行时包，然后手动双击安装。这属于老牌硬核操作，只是现在很少有人知道了。下载后打开 dmg，里面会有 “Install” 脚本或
.pkg安装包，双击即可。装完再重启 Xcode，模拟器列表就认出来了。这个方法同样适用于 Xcode 26 或 Xcode 14.2 这类特定版本环境。
7. 一个标准的“重置模拟器环境”操作流程
最后，我把前面所有知识浓缩成一个完整的、按顺序执行的“重置流程”。这个方法适用于绝大部分顽固问题。它不会影响你的源代码，但会清除所有模拟器、模拟器内容和 Xcode 的设备缓存，让你的开发环境回到“出厂状态”。整体耗时大约 5 到 10 分钟，视你机器性能和模拟器数量而定。
第一步，关闭 Xcode 和模拟器。
第二步，删除所有模拟器设备，但保留运行时：
xcrun simctl shutdown all xcrun simctl delete all注意：delete all会删除所有已经注册的模拟器设备，因为运行时是独立的，所以后续可以重新创建。如果你的模拟器里存有什么重要的 App 数据，这里建议先备份，不过对绝大多数开发场景来说，模拟器里的数据丢了也没什么。
第三步，重置 CoreSimulator 服务。这一步在高版本的 macOS 上，直接用killall比launchctl remove更可靠：
killall -9 com.apple.CoreSimulator.CoreSimulatorService如果提示 “No matching processes”，说明服务本来就没在运行，没关系，继续下一步。
第四步，清掉 Xcode 的设备管理器缓存：
defaults delete com.apple.dt.Xcode DVTDeviceManagerList defaults delete com.apple.dt.Xcode IDEProvidingDevicesManagerList 2>/dev/null第五步，删除 DerivedData 缓存中对应项目的文件夹。不放心的话，可以清空整个 DerivedData 目录，代价就是下次打开项目会重新索引，耗时看工程大小。用命令行操作的话：
rm -rf ~/Library/Developer/Xcode/DerivedData/*第六步，打开 Xcode。在启动界面选择 “Open a project or file”，等待项目索引和加载完成。然后去设备列表处点击运行目标下拉菜单，正常情况下，里面应该列出了各种 iOS 模拟器。如果没有，再打开 “Devices and Simulators”，点击左下角 “+”，手动创建模拟器，选择对应设备类型，比如 iPhone 15 Pro 和 iOS 17.4 的运行时。
第七步，如果你想再验证一下 CoreSimulator 是否健康，执行xcrun simctl list devices，观察是否列出了新建的设备和正确的状态。
提示：这一套流程非常“粗暴”，但效果是立竿见影的。我把它命名为“Nuke and Pave”（全拆重铺），基本上能解决九成以上模拟器识别异常。如果你跑完这套流程还不行，那问题多半在你的项目本身而不是开发环境了。
8. 防患于未然：平时怎么避免再出现这个问题
虽然文章快结束了，但我觉得比起“出了问题怎么修”，更重要的是告诉你“平时怎么避免”。第一个建议是，保持 Xcode 和模拟器运行时的版本相对统一。虽然新版 Xcode 一般能运行旧版模拟器，但如果你的 Xcode 大版本升级了，记得去 Components 里把最新版本的模拟器运行时装上，尤其是 Major Version 升级时，比如从 Xcode 14 升到 Xcode 15。
第二个建议是，尽量避免多版本 Xcode 同时运行。我知道做逆向开发或兼容性测试的时候会用到多版本，但 CoreSimulator 这个服务似乎并不太喜欢频繁切换。如果非要装多版本，建议打电话给朋友先吐槽一下，但至少用xcode-select固定默认版本，并且不要同时打开两个 Xcode 的调试会话。
第三个建议是，定期清理 DerivedData 和模拟器的无用设备。我自己习惯每两个星期删一次 DerivedData 里超过一周没打开的项目的缓存，同时在 “Devices and Simulators” 里删掉那些我根本不会用到的旧设备（比如 iPhone SE 第一代），只保留两到三个主力设备（一台小屏、一台大屏、一台 Pro 系列）。设备越少，CoreSimulator 的负担越小，出问题的概率自然就低。
最后一个建议是，养成用命令行创建模拟器的习惯。这听起来有点黑客范儿，但实际上它是非常可靠的。因为图形界面在创建模拟器时会自动附加很多默认选项，但命令行创建会更纯粹，冲突概率也小。大家打开终端，打下这段命令：
xcrun simctl create "iPhone 15 Pro Test" "com.apple.CoreSimulator.SimDeviceType.iPhone-15-Pro" "com.apple.CoreSimulator.SimRuntime.iOS-17-4"这样你就能在几秒钟内创建出一台命名精准、配置可靠的模拟器，完全避开了图形界面可能出现的状态同步问题。
根据我个人实际操作的经验，“搜索不到 iOS 模拟器”这个问题，绝大多数情况下都不是什么大毛病，更不是你的代码有问题，而是 Xcode 环境、设备定义和运行时三者之间的协调出了问题。只要按照文章的顺序，先从项目配置查起，再检查运行时安装情况，最后重置 CoreSimulator 和缓存，基本都能顺利解决。最后再提醒一点：遇到问题先别急着重装 Xcode，那是一个十几 G 的庞然大物，下载和安装时间够你手动排查十遍以上了。可以先从最轻量的设备列表刷新开始尝试，一步步加深重置力度，通常你会在走到重装那一步之前发现问题所在。
