如何在 Mac 上卸载 QGIS

QGIS 把每个用户配置文件都放在 ~/Library/Application Support/QGIS 下，设置、装好的插件、存下的样式、处理模型，还有保存连接凭据的认证数据库都在里面，工程和 GIS 数据则是你自己存下的文件，移除应用碰不到它们。想以后找回插件和凭据，删任何东西之前先把配置文件夹备份好。这篇覆盖 qgis.org 的磁盘映像和 Homebrew cask qgis。

先备份用户配置

QGIS 用户手册里说，一个用户配置包含全局设置、快捷键、插件和插件设置、工程模板、处理脚本和模型、自定义样式与调色板，以及认证数据库 qgis-auth.db。在 QGIS 里选 Settings › User Profiles › Open Active Profile Folder（中文界面在「设置」菜单里找用户配置那一项），打开正在用的配置，再把它复制到 QGIS 文件夹以外。手册给出的 QGIS 3 在 macOS 上的位置是 ~/Library/Application Support/QGIS/QGIS3/profiles/，更新的大版本可能换了子文件夹名，所以用菜单找最稳。

qgis-auth.db 存着你为数据库和网络服务保存的凭据，由 QGIS 主密码保护，只复制文件、不记得主密码，这份副本也用不上。

工程（.qgz 和 .qgs 文件）、GeoPackage、shapefile 和栅格数据都在你当初存的地方，它们不属于这个应用，留着就好。

退出 QGIS，移除应用

  1. 存好工程，从 QGIS 菜单退出。
  2. 打开「活动监视器」搜索 QGIS，确认它已经退出。
  3. 在访达的「应用程序」里找到 QGIS 移到废纸篓。官方磁盘映像里的应用名带着版本号，比如 QGIS-final-4_2_2.app，所以看一下所有以 QGIS 开头的应用，只删不再需要的那几个版本。

两次测试都没看到 QGIS 注册登录项、后台项目或启动代理，QGIS 自带的 GDAL 工具和 Python 都在应用包里面，跟着应用一起走。

QGIS 的数据放在哪里

在访达按 Shift + Command + G 逐个打开，不存在的跳过。

位置 里面是什么 如何处理
~/Library/Application Support/QGIS 用户配置，含设置、插件、样式、模板、处理模型和 qgis-auth.db 先备份，要重装就留着
~/Library/Caches/QGIS 缓存，测试时启动一次约 1 MB 退出后可以删
~/Library/Saved Application State 里以 org.qgis.qgis 开头的项目 窗口恢复状态，cask 的 zap 清单里有 可以删

检查结果

应用进废纸篓后，在「终端」里运行这几条只读命令：

pgrep -il qgis
ls /Applications | grep -i qgis
ls "$HOME/Library/Application Support/QGIS"
  • pgrep 没有输出，说明 QGIS 已经不在运行，列出进程说明它还开着，复制配置之前先退出。
  • 第二条没有输出，说明「应用程序」里已经没有名字带 QGIS 的应用，列出名字说明还有别的副本，常常是旧版本，留不留单独决定。
  • 最后一条 ls 列出 QGIS3 这类文件夹，说明用户配置还在，选择保留时这正是想要的结果，提示「No such file or directory」说明文件夹已经不在。

用 Homebrew 安装时

qgis 这个 cask 的 zap 清单包含放着所有用户配置的 ~/Library/Application Support/QGIS、~/Library/Caches/QGIS 和窗口恢复状态。自己运行 brew uninstall --cask --zap qgis 会把它们全部移进废纸篓，插件和保存的凭据也在其中，不看你在 Mole 里勾了什么。想保留用户配置，只移除应用：

brew uninstall --cask qgis

只有 zap 清单里每条路径都在 ~/Library 下、没有碰到你没勾选的行、也没有被其他已装应用认领时，Mole 才加 --zap。~/Library/Application Support/QGIS 这一行默认不勾选，所以除非你自己勾上它，Mole 不会加 --zap。

Mole 会列出什么

以下是 Mole 对 qgis.org 下载版的处理：

  • 应用名带版本号时，Mole 也能认出它是 QGIS，按这个名字列出它的文件夹。
  • ~/Library/Application Support/QGIS 会列出，但默认不勾选，不主动勾上，用户配置就留着。
  • ~/Library/Caches/QGIS 和按 bundle ID 存放的临时缓存默认勾选。
  • 你的工程和数据文件不会列出。

这次检查覆盖了什么

2026 年 9 月 21 日，从官方磁盘映像把 QGIS 以 QGIS.app 这个名字拷进「应用程序」，打开后没有建工程，再用 Mole 1.15 的 Preview 构建全选卸载，没有 Homebrew 安装记录，约 1 MB 的 Application Support 文件夹和缓存都进了废纸篓。2026 年 9 月 26 日又从同一个官方磁盘映像重装，这次保留原名 QGIS-final-4_2_2.app，打开一次，用 Mole 的开发构建全选卸载，Mole 的「状态」页把它显示成名为 QGIS 的一行，3 个进程约 445 MB，4 项全部进了废纸篓，清单上的东西、进程和启动项都没有留下。插件、保存的凭据、工程和 Homebrew cask 都没有测到。