在 Mac 上卸载 KeePassXC

KeePassXC 的密码数据库由你选择保存位置。卸载应用之前，先找到 .kdbx 文件，把数据库和配套的 key file（如果用了）一起备份，并用备份副本实际解锁一次再继续；只有数据库而缺少密钥文件，仍可能无法打开。本页覆盖 keepassxc.org 官网的 DMG 和 Homebrew cask。

保存配置与数据库

这次 Mac 测试看到的配置文件是 ~/Library/Application Support/KeePassXC/keepassxc.ini。在 Finder 按 Shift + Command + G 打开它所在的文件夹，退出 KeePassXC 后复制这个文件夹留作备份。配置不等于数据库，也不能用它恢复密码。

~/.keepassxc 是另一个需要核对的可能位置，本次测试没有写出这个目录。找不到就直接跳过，不必为了凑齐清单到处找同名文件。

移除应用，再决定是否删除配置

保存数据库并退出 KeePassXC，在「应用程序」里把 KeePassXC 移到废纸篓。不再需要的配置可以随后删除，仍在使用的 .kdbx 数据库和 key file 保留在原处。KeePassXC 文档

如果用过浏览器集成，KeePassXC 会在你启用的每个浏览器的 NativeMessagingHosts 文件夹里写入一个名为 org.keepassxc.keepassxc_browser.json 的连接文件，例如 ~/Library/Application Support/Google/Chrome/NativeMessagingHosts 或 ~/Library/Application Support/Mozilla/NativeMessagingHosts（KeePassXC 源代码）。这个文件不含密码。应用删掉后，把每个文件夹里的这一个文件删掉，KeePassXC-Browser 扩展则在浏览器里另外卸载。

KeePassXC 的文件在哪里

检查结果

pgrep -il keepassxc
ls -d ~/Library/Application\ Support/KeePassXC ~/.keepassxc
find "$HOME/Library/Application Support" -type f -path '*/NativeMessagingHosts/org.keepassxc.keepassxc_browser.json' -print

pgrep 没有输出，说明 KeePassXC 已退出。ls -d 报 No such file or directory，说明该文件夹已经不在；列出了路径说明还在磁盘上。最后一条列出仍存在的完整浏览器连接文件，只有命令正常完成且没有错误时，无输出才表示没找到，权限错误涉及的目录仍未核实。查看每份 JSON 的 path，只移除指向本次已删除 KeePassXC 安装的连接文件，保留浏览器目录及其他文件。最后用保留的兼容客户端或另一台设备打开数据库，确认能正常访问。

用 Homebrew 安装时

Mole 会先检查 zap 清单，涉及未勾选的数据、其他应用共用的文件或无法确认的内容时不执行 --zap，已勾选的残留仍由 Mole 清理。

自己运行 brew uninstall --cask --zap keepassxc 时，zap 清单不看你在 Mole 里勾了哪些行。它会把 ~/.keepassxc 和 ~/Library/Application Support/keepassxc（应用设置）移到废纸篓，缓存、偏好设置、崩溃报告和窗口恢复状态也在清单里。它不会碰你保存在其他位置的 .kdbx 数据库，也不会碰浏览器连接文件。想保留设置就先备份那个文件夹，或改用不带 zap 的 brew uninstall --cask keepassxc。

数据库打不开时先别删旧文件

用备份副本解锁失败时，先确认密码、key file 和数据库是不是同一套，不要反复重装 KeePassXC 或清空 keepassxc.ini 来碰运气。配置文件只记录程序设置，真正的密码仍在你选择保存的 .kdbx 里。如果数据库在同步盘，还要确认复制的是下载完整的文件。

卸载后若 Finder 里仍能找到 .kdbx，这通常是你要保留的资料，不应作为应用残留移到废纸篓。

Mole 会列出什么

默认关闭「卸载时一并移除数据和配置」时，下面两条用户数据行不勾选，开启后符合条件的应用自有数据可能预先勾选，想保留配置就取消这些行的勾选。

Mole 不会全盘搜集数据库作为残留，Chrome、Chromium、Edge、Firefox 和 Vivaldi 文件夹里的 org.keepassxc.keepassxc_browser.json 连接文件，只要 path 指向 KeePassXC.app，就会列出并默认勾选，其他浏览器文件夹里剩下的用上面最后一条检查命令找。

这次检查覆盖了什么

2026 年 9 月 17 日用 Homebrew cask 安装 KeePassXC，再通过 Mole 卸载，过程中执行了 zap 清单。zap 删掉了 ~/Library/Application Support/KeePassXC/keepassxc.ini。应用没有创建 ~/.keepassxc，Mole 为它补的一行依据是 zap 清单列出了这个路径。打开真实数据库和浏览器集成都没有测试。