Upscayl 在 macOS 上无法正常运行时如何清理本地数据文件并重置应用？
【免费下载链接】upscayl🆙 Upscayl - #1 Free and Open Source AI Image Upscaler for Linux, MacOS and Windows.项目地址: https://gitcode.com/GitHub_Trending/up/upscayl
如果你在 macOS 上运行 Upscayl 时应用打不开、无响应或行为异常，官方排错文档给出的处理方式是：把~/Library目录下所有与upscayl相关的数据文件和文件夹删除，让应用回到首次安装的状态，然后重新打开。本文只覆盖 macOS 平台，操作通过 Finder 完成，不需要终端命令。
清理前先确认的两件事
在删除任何文件之前，按 MacOS 排错文档 的顺序先做判断：
- 确认 macOS 是最新版本。文档要求先使用最新的 macOS 更新，确认后再执行下面的清理步骤。
- 确认你不是 macOS Monterey 的黑屏问题。文档明确指出：Monterey 上可能出现空黑屏，原因是 Monterey 对 Electron 应用存在系统级 bug，这不是 Upscayl 能修复的，删除数据文件也解决不了。文档建议升级到你的设备支持的最新 macOS 版本。如果你的机器还在 Monterey 上，应优先升级系统，而不是清理文件。
打开 ~/Library 目录
macOS 的用户Library目录默认在 Finder 侧栏中不可见，按文档给出的路径操作：
- 打开 Finder；
- 点击顶部菜单栏的Go；
- 在下拉菜单中选择Go to Folder；
- 在弹出的输入框中输入
~/Library/并按回车。
需要删除的 Upscayl 本地数据文件
进入Library目录后，查找并删除所有名称中含upscayl的文件和文件夹。文档列出了可以安全删除的完整清单：
~/Library/Application Support/Upscayl ~/Library/Saved Application State/org.upscayl.Upscayl.savedState/ ~/Library/Group Containers/W2T4W74X87.org.upscayl.Upscayl ~/Library/Containers/Upscayl（以及该目录下其他名称含 upscayl 的文件夹） ~/Library/Preferences/org.upscayl.Upscayl.plist/ ~/Library/Preferences/org.upscayl.Upscayl.helper.plist/删除时有一条明确限制：不要删除名称中不含upscayl的文件夹。这些路径保存的是 Upscayl 的 Electron 应用数据、保存的窗口状态、组容器和偏好设置，删除后相当于把应用重置到首次运行状态，不会影响系统本身或其他应用。
删除后如何判断结果
清理完成并重新打开 Upscayl 后，判断标准就是应用能否正常启动并进入界面。如果应用恢复工作，问题即已解决。
如果删除这些数据文件后问题依旧，可以继续参考 通用排错文档 中列出的其他手段：重启计算机、卸载后重新安装应用。需要注意的是，若你遇到的是 Monterey 黑屏这类系统级问题，文档说明这不是清理数据文件能够修复的，唯一建议是升级 macOS 版本。
【免费下载链接】upscayl🆙 Upscayl - #1 Free and Open Source AI Image Upscaler for Linux, MacOS and Windows.项目地址: https://gitcode.com/GitHub_Trending/up/upscayl
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
