如何彻底卸载并重新安装 Snapzy

一些用户反馈，即使在系统设置中开启了 macOS 权限（屏幕录制、麦克风、辅助功能），这些权限仍然无法生效。这通常是因为在常规卸载过程中，残留的应用数据、缓存偏好设置或旧的 TCC 记录没有被完全清除。

从 v1.25.0 更新文章过来的？ 如果 Snapzy 只是在更新到 v1.25.0 后再次请求权限，通常不需要彻底卸载。请先尝试重新授权 —— 参见更新到 v1.25.0 后 Snapzy 再次请求权限。只有重新授权无法解决时，再回到本文。

解决方案？使用我们的官方脚本进行彻底卸载，然后重新安装。

为什么要彻底卸载？

直接把 Snapzy 拖到废纸篓并不能清除所有内容。由于 Snapzy 是一款沙盒化的 macOS 应用，它的数据分散在多个位置：

沙盒容器 — ~/Library/Containers/com.trongduong.snapzy（沙盒应用存储偏好设置、缓存和文件的主要数据容器）
TCC 权限记录 — 系统在其内部数据库中仍然保留着旧的授权（或拒绝）记录
应用偏好设置 — ~/Library/Preferences/com.trongduong.snapzy.plist
缓存文件 — ~/Library/Caches/com.trongduong.snapzy
应用程序支持数据 — ~/Library/Application Support/Snapzy
保存的应用状态 — ~/Library/Saved Application State/com.trongduong.snapzy.savedState
HTTP 存储 — ~/Library/HTTPStorages/com.trongduong.snapzy

如果其中任何一项损坏或不同步，你可能会遇到权限已开启但实际未生效的问题，或者引导流程无法正确检测到你的设置。

第一步：彻底卸载 Snapzy

打开终端（你可以在 /Applications/Utilities/Terminal.app 中找到它，或者使用 ⌘ + 空格 搜索 "Terminal"），然后运行以下命令：

curl -fsSL https://raw.githubusercontent.com/duongductrong/Snapzy/master/uninstall.sh | bash

如果你在本地克隆了 Snapzy 仓库，也可以直接从项目根目录运行 ./uninstall.sh。

卸载脚本的作用

该脚本会执行彻底的清理：

终止运行中的应用 — 停止当前打开的 Snapzy
移除 Snapzy.app 从 /Applications
删除应用程序支持数据 — 移除 ~/Library/Application Support/Snapzy（临时截图/录屏文件）
删除偏好设置 — 移除 com.trongduong.snapzy 的 defaults 和 plist 文件
清除缓存 — 移除 ~/Library/Caches 和 HTTP 存储中的缓存数据
移除保存的应用状态 — 清除窗口状态数据
移除 Sparkle 更新数据 — 清除自动更新缓存和 defaults
重置 TCC 权限 — 清除 Snapzy 的屏幕录制、麦克风、辅助功能和输入监控权限条目
提示沙盒容器 — 脚本会检测到 ~/Library/Containers/com.trongduong.snapzy，但会提示你在需要时使用 sudo 手动移除

重要： 脚本运行完成后，你可能需要注销或重启 Mac，TCC 权限重置才能完全生效。这是 macOS 的要求 —— 系统需要刷新其内部权限数据库。

第二步：重新安装 Snapzy

注销/重启后，选择以下任一方式全新安装 Snapzy：

选项 A：Shell 脚本（推荐）

curl -fsSL https://raw.githubusercontent.com/duongductrong/Snapzy/v1.25.0/install.sh | bash

将 v1.25.0 替换为 Releases 页面上的最新版本号。

选项 B：Homebrew

brew tap duongductrong/snapzy https://github.com/duongductrong/Snapzy
brew install --cask snapzy

选项 C：手动下载

前往 Releases 页面
下载最新的 Snapzy-v<version>.dmg
打开 .dmg 并将 Snapzy.app 拖入 /Applications

第三步：授予权限

全新安装后首次启动 Snapzy 时：

屏幕录制 — macOS 会提示你授予屏幕录制权限。前往 系统设置 → 隐私与安全性 → 屏幕录制 并启用 Snapzy
麦克风 (可选) — 如果你需要在录屏中加入语音，在提示时授予麦克风权限
辅助功能 (可选) — 如果提示高级功能需要，请启用

授予屏幕录制权限后，macOS 可能会要求你重新启动 Snapzy —— 这是正常的。

故障排除提示

权限仍然无法生效？ — 确保你在运行卸载脚本后已经重启。macOS 会积极缓存 TCC 权限
出现"应用已损坏"错误？ — 这通常发生在较旧的 ad-hoc 构建上。从 v1.25.0 开始，Snapzy 已通过 Apple 公证，不应再出现此错误。如果仍遇到，请前往 系统设置 → 隐私与安全性，然后在 Snapzy 消息旁边点击 "仍要打开"
Homebrew 版本过旧？ — 运行 brew update && brew upgrade snapzy 获取最新版本

快速参考

以下是完整的流程，一目了然：

# 第一步：卸载
curl -fsSL https://raw.githubusercontent.com/duongductrong/Snapzy/master/uninstall.sh | bash

# 第二步：重启 Mac，然后重新安装
curl -fsSL https://raw.githubusercontent.com/duongductrong/Snapzy/v1.25.0/install.sh | bash

如果彻底重新安装后仍有问题，请在 GitHub 上提交 Issue —— 我们很乐意帮忙！