跳转到内容
QGIS
Tutorial

Mac 安装 QGIS:Apple 芯片与 Intel 教程

发布于

Mac 上的 QGIS:库比蒂诺 Apple Park 的地图,OpenStreetMap 建筑按占地面积着色,旁边标有 arm64 和 x86_64。

可以。到 2026 年,QGIS 已经能在 Mac 上原生运行,Apple 芯片和 Intel 都支持。qgis.org/download 上的官方安装包只有一个文件,两种芯片通用:里面的应用是通用二进制(universal binary),同时包含 arm64 和 x86_64 两个版本,所以 M1 到 M4 的 Mac 不需要经过 Rosetta。我在自己的 MacBook(Apple M4,16 GB,macOS 27.0.1)上于 2026 年 11 月 12 日验证过:QGIS 3.44.15 显示的运行架构是 arm64。

该选哪个文件:想要改动最少的版本,选长期支持版(LTR)3.44.15;想用 QGIS 4,选最新版 4.2.3。两者下载大小都约 1.6 GB,安装后约占 3.5 GB。

本文接下来依次讲安装步骤、我实测的数据、macOS 上不太顺手的四个问题及解决办法,以及我会最先装的插件。如果你用的是 Windows 或 Linux,通用指南见如何下载并安装 QGIS。如果你还没打开过这个软件,可以先看QGIS 是什么。

Mac 版 QGIS 下载:LTR 还是最新版

截至 2026 年 11 月 12 日,下载页列出两个 macOS 安装包。我没有下载它们,大小和日期都是从服务器上读到的。

长期支持版(LTR)最新版
版本3.44.15 "Solothurn"4.2.3 "Belém do Pará"
文件qgis_ltr_final-3_44_15.dmgqgis_pr_final-4_2_3.dmg
下载大小1.55 GB1.59 GB
文件日期2026 年 9 月 28 日2026 年 9 月 28 日
在“应用程序”中的大小(实测)3.4 GB3.6 GB
应用内的架构(实测)arm64 和 x86_64arm64 和 x86_64
安装后的应用名QGIS.appQGIS-final-4_2_3.app

QGIS 项目在那个页面上的建议很简短:“If you are unsure which version is best for you, download the LTR.”(不确定选哪个版本时,下载 LTR。)第一次安装我同意这个建议。需要 QGIS 4 的某个功能,或者同事发来的工程是用 QGIS 4 保存的,再选 4.2。另一个要先确认的是插件:大多数插件已有适配 QGIS 4 的版本,也有一些还没有,AI 插件的统计我放在了 QGIS 4 AI 插件里。

关于系统要求,安装指南写的是,安装包“are compatible with High Sierra (10.14) and newer for Intel x64 and Apple silicon (ARM) devices”(兼容 High Sierra (10.14) 及更新版本,支持 Intel x64 和 Apple 芯片设备)。High Sierra 是 macOS 10.13,10.14 是 Mojave,所以最低版本是这两者之一,2018 年以来一直保持更新的 Mac 都在支持范围内。页面没有给出内存要求。在我的 16 GB Mac 上,QGIS 和浏览器、代码编辑器同时运行,处理城市规模的数据没有问题。

如何在 Mac 上安装 QGIS

  1. 从 qgis.org 下载 DMG

    打开 qgis.org/download,选择 macOS,再选长期支持版或最新版。页面把它们描述为 "Official All-in-one, signed and notarized installers for macOS"(官方一体化、已签名并经公证的 macOS 安装包)。只从 qgis.org 下载,不要从会重新打包旧版本的下载站下载。

  2. 把 QGIS 拖进“应用程序”

    打开 DMG,把 QGIS 图标拖到“应用程序”文件夹上。没有需要一路点下去的安装程序,也不用先单独安装 GDAL 或 Python,两者都已经在应用里了。

  3. 从“应用程序”中打开一次

    在“应用程序”中双击 QGIS。macOS 会在第一次启动时检查这个应用,比之后每次启动都慢,然后让你确认是否要打开从互联网下载的应用。点击打开。

  4. 添加底图检查是否正常

    在“浏览器”面板中展开 XYZ Tiles,双击 OpenStreetMap。如果出现街道地图,安装就完成了。

写这篇文章时我没有重装 QGIS,所以上面的步骤是官方给出的步骤,首次启动的对话框是根据 Apple 的文档描述的,不是截图。我实测的是安装之后的一切,见下文。

“无法打开 QGIS”:Gatekeeper 提示

Gatekeeper 是 macOS 中拦截无法验证的应用的部分。当前的官方安装包已签名并经公证,应该只会出现简单的“从互联网下载”确认。但如果用的是旧安装包、每日构建版或从其他网站得到的副本,你仍可能遇到更严格的拦截:“无法打开 QGIS,因为 Apple 无法检查其是否包含恶意软件”。

绕过的方法来自 Apple 自己的说明,见打开来自未知开发者的 Mac App:

  1. 先尝试打开一次 QGIS,然后关掉提示。
  2. 打开系统设置 > 隐私与安全性,滚动到安全性。
  3. 点击 QGIS 那一行旁边的仍要打开,然后用密码或触控 ID 确认。

从 macOS Sequoia 起,按住 Control 点按再选“打开”已经不能跳过这一步,所以那些让你右键点击的旧教程不再管用。只对你亲自从 qgis.org 下载的文件使用这个方法。

我在 M4 MacBook 上的实测结果

项目结果
MacApple M4,16 GB,macOS 27.0.1
QGIS3.44.15 "Solothurn"(旁边还装了 4.2.3)
运行架构arm64(原生,不用 Rosetta)
应用大小3.44.15 为 3.4 GB,4.2.3 为 3.6 GB
内置 Python3.12.11,pip 26.2.1
内置 GDAL3.13.3,202 个栅格和矢量驱动
Qt3.44 中为 5.15.19,设备像素比 2.0(Retina)
可用的处理算法475 个
新配置文件,从启动到就绪约 7 秒
AI Agent 获取并设置样式的 440 个 OpenStreetMap 建筑21 秒

关于这张表有两点说明。7 秒是全新用户配置文件启动并响应第一条命令的时间,当时还开着其他应用;装了很多插件的配置文件启动会更慢。475 个算法里包含我这台机器上的三个插件提供的算法,所以干净安装显示的数量会少一些。

macOS 上运行的 QGIS 3.44:“图层”面板中有一个名为 Apple Park buildings 的图层,按面积分为五个颜色等级;地图显示库比蒂诺的 Apple Park,OpenStreetMap 底图上的建筑从黄色到深红色;AI Agent 面板显示请求和回答:440 个 OpenStreetMap 建筑轮廓,按占地面积分为五个分位数等级着色。
Apple M4 上的 QGIS 3.44.15,2026 年 11 月 12 日。底图和建筑数据 © OpenStreetMap contributors。

macOS 上不太顺手的地方和解决办法

QGIS 的大部分行为在 Mac 和 Windows 上是一样的。下面这四点是不一样的地方。

1. 需要额外 Python 包的插件

有些插件需要 QGIS 没有自带的 Python 包,它们的错误信息是 No module named ...。在 Mac 上,起作用的是应用内部的 Python,不是 Homebrew 或 python.org 的 Python。用终端里平时的 pip 安装,包会装到 QGIS 永远不会去找的地方。

我检查了内置 Python 的行为。直接在终端调用 /Applications/QGIS.app/Contents/MacOS/python3.12 会停在 "Could not find platform independent libraries"。告诉它主目录在哪里之后就能正常运行:

PYTHONHOME=/Applications/QGIS.app/Contents/Frameworks \
  /Applications/QGIS.app/Contents/MacOS/python3.12 -m pip install --user <package>

加上 --user,包会装到 ~/.local/lib/python3.12/site-packages,这个文件夹在我的 Mac 上位于 QGIS 的 Python 路径中。因为它在应用之外,所以 QGIS 更新后也还在。装完后重启 QGIS。上面的命令我只运行到了 pip --version,写这篇文章时没有真的安装新包。

做得好的插件会在首次运行时自己安装依赖,让你省掉这些步骤。

2. Mac 版打不开的格式

内置的 GDAL 有 202 个驱动,常见格式都有:GeoPackage、Shapefile、GeoJSON、KML、DXF、GeoTIFF 和 COG、GeoParquet、NetCDF、PostGIS,以及用于 Esri 文件地理数据库的 OpenFileGDB。人们常问的四种格式在我这台机器上没有:

格式Mac 版中的驱动怎么办
DWG(AutoCAD)没有在 CAD 软件中导出 DXF,或先转换
ECW没有请对方提供 GeoTIFF 或 COG
MrSID没有请对方提供 GeoTIFF 或 JPEG 2000
FileGDB(Esri 自己的 SDK 驱动)没有OpenFileGDB 可以读写 .gdb

所以当 .dwg 或 .ecw 文件加载失败时,文件本身没问题,是缺少驱动。你可以在设置 > 选项 > GDAL 中检查自己的安装。

3. 两个版本并存

LTR 安装为 QGIS.app,4.2.3 安装为 QGIS-final-4_2_3.app,所以两者可以同时放在“应用程序”里,互不覆盖。我两个都用。它们的设置也是分开的:QGIS 3 的配置文件在 ~/Library/Application Support/QGIS/QGIS3,QGIS 4 的在 ~/Library/Application Support/QGIS/QGIS4,所以你在一个版本里的插件和工具栏不会带到另一个版本。两个版本合计要预留 7 GB 磁盘空间。

在 QGIS 4 中保存的工程,在 3.44 中可能无法正常打开。用新版本打开旧工程之前,请先留一份副本。

4. 卸载,或者从头开始

把应用从“应用程序”拖进废纸篓。这会删除 3.4 GB 的应用,但保留你的设置和插件,更新前这样做正合适。要完全重置,还需要删除上面提到的 QGIS3 或 QGIS4 文件夹。我的默认配置文件有 4.9 GB,磁盘空间紧张时值得看一眼。

在全部删除之前,先试试新建配置文件:设置 > 用户配置文件 > 新建配置文件,几秒钟就能得到一个干净的 QGIS,还能告诉你问题是不是某个插件引起的。

Homebrew、MacPorts 和 conda

官方安装包是我用的方式,也是我唯一测试过的。其他方式也存在,下面是它们各自官方页面上的说法。

方式安装内容本文中的状态
官方 DMG3.44.15 LTR 或 4.2.3,通用版已测试
Homebrew caskbrew install --cask qgis 安装 4.2.3,qgis@ltr 安装 3.44.15:都是同一个官方应用来自 brew info,未安装
MacPorts端口 qgis3 和 qgis3-ltr,按你的架构编译,位于 /Applications/MacPorts/QGIS3.app来自 QGIS 指南,未测试
conda-forgeconda 环境中的 qgis 包未测试

QGIS 安装指南中有一条警告:同一台 Mac 上同时使用 Homebrew 和 MacPorts "will almost certainly lead to conflicts"(几乎肯定会产生冲突)。只选一个。

在 Mac 上好用的插件

插件通过插件 > 管理并安装插件安装,所有系统上的方式都一样。下面是我在新 Mac 上最先装的几个,全部在 Apple 芯片上运行过。

1. QuickMapServices,用于底图

它提供一个现成背景地图的菜单,不用手动粘贴瓦片地址。具体步骤和各数据源的使用条款见如何在 QGIS 中添加底图。

2. AI Agent,一句话就能得到地图

AI Agent 是我们自己的插件:QGIS 里的一个聊天面板,替你运行各种工具。你描述想要的结果,它去获取数据、运行处理、设置图层样式,每一步都看得见,也可以撤销。

为这篇文章,我在 M4 上运行了一次请求,工程是空的,只有一张 OpenStreetMap 底图。

在 Apple M4 上的一次真实运行:21 秒,三个工具。最大的建筑轮廓是那个环形主楼,面积为 81,245 m²。Get the free QGIS pluginFree plan, no credit card.

手动做同样的地图,要用到 QuickOSM、字段计算器和符号系统面板,练习一次很有用,做到第十次就嫌慢了。它的限制也很明确:AI Agent 需要联网,免费方案有每月的消息额度,而且在相信答案里的数字之前,应该先读一读答案。完整的操作演示见 AI Agent 指南。

3. QuickOSM,用于 OpenStreetMap 数据

它可以下载某个区域的道路、建筑或任何带标签的对象。可用的查询见在 QGIS 中下载 OSM 数据。

想按任务查看更长的列表,见最好用的 QGIS 插件。如果这是你使用这个软件的第一个小时,QGIS 新手教程会一步步带你做出第一张地图,用不用 AI Agent 都可以。

要点回顾

  • 一个官方安装包同时适用于 Apple 芯片和 Intel,两者都是原生运行。
  • 除非需要 QGIS 4(4.2.3),否则选 LTR(3.44.15)。两个版本可以并存。
  • 每个版本预留 1.6 GB 下载空间和 3.5 GB 安装空间。
  • 插件用的 Python 包要通过 QGIS.app 内部的 Python 安装,不是系统自带的 Python。
  • DWG、ECW 和 MrSID 在 Mac 版中打不开。请对方提供 DXF 或 GeoTIFF。

常见问题

免费试用 AI Agent

在 QGIS 里,说一句就能完成

AI Agent 会在你自己的 QGIS 项目中,完成你描述的任务。免费使用,无需绑卡。

免费试用 AI Agent
由以下作者撰写Yvann Barbot
·6 min read

继续阅读

航拍的村庄,花园里和街道两旁的每个树冠都被填上各自的颜色,成为单独的多边形。
AI SegmentationQGISTutorial

QGIS 树木普查:用航拍影像或 LiDAR 建立树木清查

在 QGIS 中做树木普查:先用航拍影像或 LiDAR 为每棵树生成一个点,在室内算出编号、冠幅和树高,再带着手机和平板到野外,用 QField 补充树种与健康状况,最后整理成一份每棵树都有完整记录、可随时更新、能直接用于日常养护管理的树木台账。

Yvann BarbotYvann Barbot
·