STACIO WIKI · 安装排障
macOS 无法打开 Stacio 或提示已损坏怎么办
1. 先确认是否适用
这篇文档仅用于处理从 Stacio 官网、官方 GitHub Release 或官方 Gitee Release 下载的 Stacio 安装包。当前安装包尚未使用 Apple notarization 发布，macOS 的来源与隔离机制可能会在首次打开时显示拦截提示。
不要因为看到本文的命令，就对来源不明的软件、附件或网盘下载的应用解除隔离属性。该命令不会修复损坏的文件，也不应被用于绕过你不信任的软件安全提示。
先核对来源。 如果文件不是从官方发布页面取得，或下载过程中曾中断、被转发、被解压缩工具改写，请删除该副本并重新从官方来源下载。
2. 先完成正确安装
- 确认下载的是适合当前 Mac 的安装包：Apple Silicon Mac 使用
arm64，Intel Mac 使用x86_64。 - 双击 DMG 后，将
Stacio.app拖入 Finder 的应用程序文件夹。 - 等待复制完成，再退出 DMG 并弹出安装盘；不要直接从 DMG 窗口或“下载”目录中运行应用。
- 在 Finder 的“应用程序”中找到
Stacio.app后再尝试打开。
应用位于 /Applications/Stacio.app 时，下面的命令可直接使用。若你自行把应用放到了其他位置，请先改用实际路径。
3. 优先用 Finder 允许首次打开
3.1 右键打开
- 在 Finder 中打开应用程序文件夹。
- 按住 Control 键点按
Stacio.app，或右键点按它。 - 选择打开，然后在确认窗口中再次选择打开。
3.2 在“隐私与安全性”中允许
如果系统只显示“无法验证开发者”或阻止打开，请打开系统设置 > 隐私与安全性，滚动到安全性区域，确认提示确实针对 Stacio 后选择仍要打开。完成一次后，通常无需重复操作。
4. 仍提示“已损坏，应移到废纸篓”时
当你已确认来源、完成安装、并且 Finder 的正常打开方式仍无效时，可在终端移除 Stacio 的 macOS 下载隔离属性。先完全退出 Stacio，再打开终端并执行：
sudo xattr -rd com.apple.quarantine /Applications/Stacio.app- 粘贴命令后按 Return。
- 系统要求输入管理员密码时，输入的字符不会显示在屏幕上，这是 macOS 的正常行为。输入完成后按 Return。
- 命令没有输出且回到提示符，通常表示执行完成。回到 Finder，再次打开 Stacio。
这条命令只针对 Stacio.app 移除 com.apple.quarantine 属性。它不会赋予应用新的签名、不会替代系统恶意软件检测，也不会修复下载不完整的安装包。
4.1 Stacio 不在“应用程序”文件夹
如果你把 Stacio 安装在其他位置，请将命令中的路径改为实际应用路径，并用引号包住路径。例如：
sudo xattr -rd com.apple.quarantine "/Users/your-name/Applications/Stacio.app"不要对 DMG 文件执行这条命令。应当先把 Stacio.app 放入一个稳定的本地文件夹，再针对该应用执行。
5. 命令报错或仍无法打开
| 现象 | 检查与下一步 |
|---|---|
No such file or directory | 应用不在 /Applications/Stacio.app。在 Finder 确认位置，或在终端运行 ls /Applications/Stacio.app 后再使用正确路径。 |
| 仍提示已损坏 | 删除当前 DMG 和应用副本，从官方页面重新下载。确认下载完成，并核对下载区公布的文件大小和 SHA-256。 |
| 打开后立刻退出或无法使用 | 确认安装包架构与 Mac 匹配，并检查 macOS 是否为 14 或更高版本。隔离属性不是所有启动问题的原因。 |
| 公司设备无法允许打开 | 设备管理、终端防护或企业安全策略可能阻止应用执行。请先联系设备管理员，不要尝试绕过组织策略。 |
6. 联系支持前请准备
如果重新下载并完成以上步骤后仍无法打开，请联系 support@stacio.cn，并提供：Stacio 版本、macOS 版本、Apple Silicon 或 Intel、完整提示截图、安装包来源，以及命令执行后的错误文本。请勿发送密码、私钥、License Key 或其他敏感凭据。