---
title: "更新与排障"
description: "了解 LaunchNext 的更新状态、更新说明、更新器控制项以及最常见问题的处理方式。"
url: "https://docs.closex.org/zh/launchnext/updates-and-troubleshooting.html"
markdown_url: "https://docs.closex.org/zh/launchnext/updates-and-troubleshooting.md"
site: "CloseX Docs"
product: "LaunchNext"
language: "zh-Hans"
last_updated: "2026-09-06T14:50:57.000Z"
alternates:
  en: "https://docs.closex.org/launchnext/updates-and-troubleshooting.md"
  zh-Hans: "https://docs.closex.org/zh/launchnext/updates-and-troubleshooting.md"
  ja: "https://docs.closex.org/ja/launchnext/updates-and-troubleshooting.md"
---

# 更新与排障

## 更新页现在会显示什么

在 `设置 > 更新` 中，LaunchNext 现在把整个更新流程集中到了同一页。

### 顶部区域

顶部的大图区域会根据当前状态变化：

- 平时显示当前版本信息
- 检查成功且已是最新时显示 `版本已是最新`
- 找到新版本时显示 `有可用更新`

### 控制项

这个页面的主要控制项包括：

- `检查更新` 或 `重新检查`：手动发起检查
- `下载更新`：仅在发现新版本后出现
- `自动检查更新`：决定是否在后台自动检查
- `打开更新配置文件`：打开更新器配置文件，方便排查或手动清理

### 状态卡

状态卡会显示以下几类状态：

- 空闲状态
- 检查中
- 已是最新
- 有可用更新，并显示版本号
- 检查失败，并显示错误信息

### 更新说明

如果这个版本附带更新说明，LaunchNext 现在会直接在设置页里把它按 Markdown 渲染出来。

这意味着你不需要离开应用，就可以先阅读标题、列表、代码块和正文，再决定是否下载更新。

## 推荐更新流程

1. 打开 `设置 > 更新`。
2. 点击 `检查更新`。
3. 如果发现新版本，先看状态卡和 `更新说明` 区域。
4. 点击 `下载更新`。
5. 如果更新器行为异常，再用 `打开更新配置文件` 检查更新器状态。

## 常见问题

## 应用被 macOS 拦截

2.4.2 及之后的 release 已签名并公证，使用最新构建通常不会遇到这个问题。旧版本、未签名构建或你自己构建的副本仍然可能被拦截。

```bash
sudo xattr -r -d com.apple.quarantine /Applications/LaunchNext.app
```

仅对你信任的应用执行该命令。

## 检查更新失败

- 先确认网络连接正常。
- 再点击一次 `重新检查` 刷新状态。
- 如果你怀疑更新器缓存或状态文件异常，可以打开更新配置文件检查。

## 更新说明为空

有些版本本身就没有附带更新说明，这不一定代表出错。  
如果版本号正常显示，并且可以下载更新，通常说明更新器仍在正常工作。

## 导入失败

- 确认所选目录包含 `Data.store`
- 确认备份目录格式有效（`LaunchNext_... .launchnext`）
- 重试导入时先只选择必要分区

## 更改来源后应用缺失

- 重新打开 设置 > 应用来源
- 确认自定义路径仍存在
- 刷新应用数据

## 快捷键或手势突然失效

- 在 `设置 > 快捷键与手势` 重新录制快捷键
- 如果是触控板手势，先确认 macOS 的 `显示桌面` 已关闭
- 如果问题出现在睡眠唤醒之后，重启一次 LaunchNext 以彻底重置输入监听
