---
title: "更新检查、下载或安装失败"
description: "先判断失败发生在检查、下载还是安装。"
slug: "update-download-fails"
category: "troubleshooting"
language: zh-CN
editorial_status: published
capability_status: guide
reviewed_at: 2026-10-13
keywords: ["更新失败","下载排查","安装恢复"]
---

# 更新检查、下载或安装失败

先判断失败发生在检查、下载还是安装。调查期间保留可用应用与有用草稿，不要先删除本地数据。

## 检查路径
确认版本及是否使用旧更新源。0.2.1 及以前和旧源安装，需要手动替换一次为当前官方包。

当前路径无法检查或下载时，保留准确报错，单独核对网络。安装失败时记录录音、发送或保存是否仍进行。已发布路径在主动退出时安装，不应在这些动作中强退。

## 证据范围
已审核记录包含测试 Mac 的真实迁移和自动升级，但真实 Intel、全新系统、断电和磁盘满场景仍不完整。这些条件下失败需要独立证据。

手动替换参考官方安装说明。重开后确认版本并检查重要草稿。CueSpec 与 Codex 更新是独立过程，其中一个更新成功不证明另一个最新或兼容。

## 相关阅读

- [更新日志](/zh/updates/)
- [录音已开始，却没有可用音频](/zh/no-recorded-audio/)
- [Fn 无法开始录音](/zh/fn-not-triggering/)
- [CueSpec 产品事实速览](/zh/product-facts/)