症状：Unity 6.5 iOS 打包按钮灰色。最快解法：先在 Unity Hub 为当前 Unity 6.5 编辑器确认已安装 iOS Build Support，再在 Build Profiles 中创建并启用 iOS 配置；如果你使用 Windows，Unity 可以生成 Xcode 项目，但最终构建、Simulator 运行和签名仍要进入兼容的 Mac 与 Xcode 环境。
这篇文章适合第一次把 Unity 项目导出到 iOS 的学生：包括使用 Windows、本地 Mac、学校电脑，或通过远程 Mac 学习的初学者。如果你已经看到 iOS，却发现 Build 或 Build And Run 不能点击，也可以直接从对应场景开始排查。
最后更新于 2026 年 9 月 20 日，版本与菜单信息核实自 Unity 6.5 官方说明、Unity iOS 构建文档 及 Apple Xcode 系统要求。
先判断：按钮究竟灰在哪里？
不要一看到灰色按钮就重装 Unity。你需要先区分是“平台没有出现”“平台出现但配置没有启用”“构建条件不完整”，还是“Windows 本身无法完成第二阶段构建”。
| 你看到的现象 | 更可能的原因 | 第一处检查位置 | 阶段性成功标准 |
|---|---|---|---|
| Platform Browser 中没有 iOS | 当前编辑器没有安装 iOS Build Support | Unity Hub 的编辑器模块 | 重新打开 Platform Browser 后能看到 iOS |
| iOS 可以看到，但没有 Active 标记 | 只创建了平台，没有切换到活动 Build Profile | File > Build Profiles |
iOS 配置旁出现 Active |
Build 和 Build And Run 都灰色 |
没有有效配置、场景或必要项目设置 | Build Profiles、场景列表、Player Settings | 能选择输出目录 |
| Windows 上能生成项目，但不能运行应用 | 缺少 macOS 上的 Xcode 阶段 | Mac、Xcode、Simulator 或真机 | Xcode 能打开并开始构建 |
Unity 6.5 对应的编辑器版本线是 6000.5，官方文档也将 Build Profiles 作为构建配置的管理入口。不要把课程里写的“Unity 6.5”误认为任何 Unity 6 版本都能替代；先在 Unity Hub 核对项目实际使用的编辑器版本。(Unity 6.5 官方说明)
第一种场景：平台列表缺少 iOS
如果 Platform Browser 里根本没有 iOS，最常见原因不是项目损坏，而是当前 Unity 6.5 编辑器没有安装 iOS Build Support。它可以理解成课程工具包：Unity 编辑器本体负责编辑场景和脚本，iOS Build Support 才让编辑器具备整理 iOS 输出文件的能力。
请通过 Unity Hub 给正在使用的编辑器追加模块，不要从论坛、网盘或不明脚本下载所谓“独立 iOS 模块”。Unity 的 Platform Browser 在目标平台模块缺失时，也会提供通过 Unity Hub 安装的入口；这比手动复制文件更稳妥。(Platform Browser 官方参考)
按下面流程操作：
- 关闭正在运行的 Unity 6.5 项目，保留项目文件夹不动。
- 打开 Unity Hub，进入已安装的编辑器列表。
- 找到课程项目正在使用的 Unity 6.5 版本，不要随意给另一个版本安装模块。
- 打开该编辑器的管理或添加模块入口。
- 勾选 iOS Build Support，按 Hub 提示完成安装。
- 安装结束后完全退出并重新打开 Unity Hub，再启动项目。
- 在 Unity 中进入
File > Build Profiles，选择Add Build Profile，重新观察 Platform Browser。
验收标准：重新打开 Platform Browser 后，列表中出现 iOS，并且可以继续点击 Add Build Profile。如果仍然没有 iOS，先确认你安装模块的编辑器版本与项目右下角显示的版本完全一致，再考虑清理 Hub 缓存或联系课程管理员，不要继续反复重装整个项目。
第二种场景：模块已安装但构建仍不可用
看到 iOS 选项，只说明工具包已经到位，不代表项目已经选中了 iOS。Unity 6.5 的 Build Profile 可以理解成“作业配置单”：它记录目标平台、场景和部分构建设置。你如果停留在 Windows 配置，iOS 的 Build 仍然可能不可用。
在 File > Build Profiles 中执行：
- 点击
Add Build Profile。 - 在 Platform Browser 中选择 iOS。
- 点击
Add Build Profile创建配置。 - 选中刚创建的 iOS 配置，点击
Switch Profile。 - 确认配置名称旁出现
Active标记。 - 检查课程要求的场景是否已经加入构建场景列表。
- 再观察
Build和Build And Run是否恢复可点击状态。
官方文档明确区分了“添加配置”和“切换为活动配置”这两个动作；只添加而不 Switch Profile，就像把作业配置单放进书包，却没有拿出来使用。(创建 Build Profile 的官方说明)
接着检查 iOS 的基础项目设置，但不要在这里扩展成完整发布教程：
- 在
Edit > Project Settings > Player中选择 iOS。 - 为项目填写一个有效的 Bundle Identifier，例如
com.example.studentgame。 - 确认课程要求的目标是设备还是 Simulator。
- 确认当前场景已经保存，并且确实加入了构建列表。
- 如果项目使用了插件，暂时不要先判断插件一定兼容，先用空白场景验证基础流程。
Bundle Identifier 是生成项目时使用的应用标识；Unity 的 Player Settings 文档也将应用标识列为 iOS 项目的基础设置。(Unity application identifier 官方文档)
| 检查项目 | 你应该看到什么 | 如果不符合怎么办 |
|---|---|---|
| iOS Build Profile | 有 iOS 配置，并显示 Active | 重新 Add，再 Switch Profile |
| 场景列表 | 包含课程入口场景 | 打开课程场景并加入列表 |
| Bundle Identifier | 类似 com.example.project 的唯一标识 |
删除空值、空格和特殊字符 |
| Target SDK | 与你准备使用的 Simulator 或设备一致 | 不要用设备 SDK 去启动 Simulator |
| 输出目录 | 可以选择新的文件夹 | 使用空目录，避免混入旧 Xcode 项目 |
阶段性成功标准：点击 Build 后能够选择输出目录，并生成一个 Xcode 项目。此时说明 Unity 侧的模块和配置大体正确；如果失败信息已经变成脚本、资源或插件错误，就不要继续围绕“按钮灰色”排查。
第三种场景：Windows 只完成 iOS 流程的前半段
Windows 上的 Unity 可以生成 iOS 项目，但不能在本机完成完整的最终构建。Unity 负责把场景、脚本、资源和相关库整理成 Xcode 项目；随后还需要由 Xcode 把这个项目编译成应用，处理签名，并部署到 Simulator 或真实 iPhone。
你可以把它理解成两段作业：
- Unity：整理作业。把游戏场景和代码装进一个待装订的 Xcode 项目。
- Xcode：装订和盖章。把项目编译成应用，处理签名，再交给 Simulator 或真机运行。
Unity 官方文档明确说明，第一步可以在运行 Unity Editor 的操作系统上执行，而 Xcode 只能安装在 macOS 设备上，因此 Windows 可以生成 Xcode 项目，却不能在本机完成完整的本地 iOS 构建。(Unity iOS 构建流程官方文档)
| 你的学习条件 | 能否生成 Xcode 项目 | 能否本地完成最终构建 | 更适合什么任务 |
|---|---|---|---|
| Windows 电脑 | ✅ 可以 | ❌ 不可以 | 做场景、脚本和导出前排错 |
| 学校 Mac | ✅ 可以 | ✅ 取决于权限与软件版本 | 课程演示、Simulator 调试 |
| 自己的 Mac | ✅ 可以 | ✅ 取决于 Xcode 与系统兼容性 | 连续开发和真机测试 |
| 短期远程 Mac | ✅ 可以 | ✅ 通常适合临时验证 | 截止日前完成构建、截图和提交 |
| 构建自动化 | 视服务和项目配置而定 | ✅ 可用于云端构建 | 只验证构建结果，不需要交互调试 |
如果你只是需要提交 Unity 工程或 Xcode 项目文件，Windows 可能已经够用；如果课程要求 Simulator 截图、真机运行、签名后的应用文件，或者老师要求演示完整流程，就必须进入 Mac 环境。没有 Mac 时，可以先阅读这份学校电脑不能安装 Xcode 的学习清单，确认学校设备管理和远程连接条件。
第四种场景：切到 Mac 后的 Xcode 排查
切到 Mac 之后，问题会从 Unity 界面转移到 Xcode 和目标设备。此时不要把“账号问题”“签名问题”“项目代码错误”都归结为 Unity 按钮。
1．先确认 Xcode 是否真的可用
在 Mac 上打开 Xcode，而不是只看 Applications 文件夹里有没有图标。首次启动可能需要完成组件安装或接受许可协议；如果 Xcode 无法正常启动，Unity 生成的项目自然无法完成第二阶段。
你还需要核对当前 Xcode 版本与 macOS 的支持关系。Apple 的 Xcode 系统要求页面会列出 Xcode 27 对应的 macOS、SDK、Simulator 和设备支持范围；这些要求可能随着 Xcode 27 的补丁版本变化，所以不要只看课程录屏里的版本号。相关页面已列在文首的更新说明中。
2．分清 Simulator 和真实设备
如果你只是需要提交课程作业截图，优先选择 Simulator 目标，减少数据线、设备信任和开发者账号带来的变量。若课程明确要求真机运行，再检查设备连接、信任提示、开发者账号和签名配置。
Unity 的 iOS Player Settings 中包含目标设备、SDK 版本、最低系统版本和签名相关设置；选择设备 SDK 却在 Xcode 中指向 Simulator，可能导致构建失败。(Unity iOS Player Settings 官方文档)
3．把签名失败和代码失败分开
- Xcode 报 Bundle Identifier、Team、Provisioning 或 Signing 错误：先看账号和签名配置。
- Xcode 报脚本编译错误：回 Unity 检查 C# 代码、包版本和插件。
- Simulator 启动后黑屏或崩溃：查看 Xcode 控制台和 Unity 的运行日志。
- Unity 根本没有生成项目：回到 Build Profile、场景和 iOS Build Support 检查。
不要关闭系统安全机制，不要共享 Apple 账号或证书，也不要运行来源不明的“自动修复脚本”。这些做法可能短暂绕过一个提示，却会让课程项目、账号权限和后续提交更难恢复。
第五步：用空白项目隔离环境问题
如果截止时间临近，最省时间的方法不是继续修改正式项目，而是创建一个空白 Unity 6.5 项目，使用同一个编辑器版本完成最小流程：
- [ ] 在 Unity Hub 中确认当前编辑器安装了 iOS Build Support。
- [ ] 在
File > Build Profiles中创建 iOS Build Profile。 - [ ] 点击
Switch Profile，确认 iOS 显示为 Active。 - [ ] 新建一个空场景并加入构建场景列表。
- [ ] 设置一个有效的 Bundle Identifier。
- [ ] 在 Windows 或 Mac 上点击
Build，观察能否生成 Xcode 项目。 - [ ] 将生成的 Xcode 项目复制到兼容的 Mac 环境。
- [ ] 用 Xcode 打开项目，先尝试启动 Simulator。
- [ ] 如果课程要求真机，再单独处理账号、签名和设备连接。
- [ ] 记录 Unity 版本、Xcode 版本、macOS 版本和失败日志。
如果空白项目能够生成并启动，正式项目失败的范围就缩小到插件、资源、场景、脚本或项目设置；如果空白项目也失败，优先修复基础环境，不要继续删除正式项目的 Library 文件夹或反复导入资产。
这里的 Xcode 27 不是“装上就一定能用”的万能答案。你需要把 Unity 6.5、当前 macOS、Xcode 版本和目标 SDK 放在同一条兼容链中核对；Unity 的升级说明也建议在升级版本后查看对应的变化与已知问题。(Unity 6.5 升级说明)
没有本地 Mac 时的课程交付路线
先看老师要求的交付物，而不是先决定购买或租赁设备：
- 只提交 Unity 工程：Windows 通常可以继续完成大部分场景和脚本工作。
- 只提交 Xcode 项目：Windows 也可以先生成项目，再把文件交给有 Mac 的同学或学校设备继续处理。
- 需要 Simulator 截图：需要可运行 Xcode 的 Mac。
- 需要真机演示：需要 Mac、Xcode、设备连接和签名条件。
- 需要反复交互调试：借用学校 Mac 或使用远程 Mac 通常比只做一次云端构建更合适。
如果学校 Mac 排队、权限受限，或者提交日期只剩很短时间，KVMFLUX 的远程 Mac 可以作为临时构建环境：你可以先在 Windows 上整理 Unity 项目，再通过 SSH、VNC 或网页控制台进入 Mac，完成 Xcode 项目生成后的打开、编译和 Simulator 验证。建议先用空白项目验收，再迁移正式作业；需要了解连接方式时，可以查看这份学校电脑上的远程 Mac 首次配置思路。
与 Windows 本机相比，远程 Mac 的主要代价是网络连接、文件上传和远程画面延迟；与自购 Mac 相比，它不适合你长期运行大型项目、频繁连接实体设备或需要完全离线开发。如果你只是为了赶一次课程验收，可以先根据当前可用的 Mac 方案确认连接方式、权限和环境说明，再决定是否使用。
当你的 Windows 电脑已经能生成 Xcode 项目，却卡在 Simulator、真机调试或完整应用文件时，继续反复点击 Unity 的灰色按钮通常不会解决问题，因为故障已经越过了 Unity 编辑器边界。此时，借用学校 Mac 适合有固定设备和现场调试需求；短期使用 KVMFLUX 适合临时完成环境验收和课程提交；只想验证构建结果的人，则可以进一步比较构建自动化方案。
如果你选择远程 Mac，先按空白项目完成一次从 Build Profile 到 Simulator 启动的验收，再迁移正式项目，通常比在截止日前直接上传一个未经验证的复杂工程更稳妥。