For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /zh/docs/desktop/troubleshooting.md (or send Accept: text/markdown).
桌面应用故障排除
在阻塞构建之前解决缺少工具链、空白窗口和发布签名失败。
安装与配置
在 Windows 上安装带 Windows SDK 的 C++ 生成工具和 WebView2 运行时。在 macOS 上安装 Xcode 命令行工具。在 Linux 上安装适用于你的发行版的 WebKitGTK、编译器、托盘和系统包。用 rustup 安装 Rust，重新打开终端，并在启动 Tauri 前运行 cargo check。
空白窗口通常意味着 SUPASTACK_APP_URL 无法访问或指向已停止的开发服务器；当已加载页面失去网络时会显示离线横幅。确认该 URL 能在同一台机器的浏览器中打开，并且你使用了预期的值构建。
实现流程
发布失败通常来自签名、公证或更新器块。检查 macOS 上的证书和钥匙串、Windows 上的签名证书和时间戳服务器、更新器公钥和端点路径，以及产品标识符。重新运行发布配置检查，然后在干净机器上安装产物，而不是覆盖开发构建。
验证与排障
应用启动、连接后端并顺利安装。