发布日期：2026-05-01 作者：QGISCN 团队 分类：入门教程

QGIS 是一款跨平台的开源地理信息系统软件，支持 Windows、macOS 和 Linux 三大主流操作系统。本教程将详细介绍各平台的安装步骤，并针对国内用户常见的安装问题提供解决方案，帮助您顺利完成 QGIS 的安装和配置。

1. 下载 QGIS 安装包

首先，请访问 QGISCN 下载页面 获取适合您操作系统的安装包。在下载之前，您需要了解两个版本的差异：

LTR 版本 vs Latest 版本

QGIS 提供两种版本供用户选择：

  • LTR（Long Term Release）版本：长期支持版本，每年发布一次，经过充分测试，稳定性最佳。推荐生产环境和企业用户使用。例如 QGIS 3.44 LTR。
  • Latest（最新）版本：每四个月发布一个新版本，包含最新的功能和改进。推荐希望体验新功能的用户和开发者使用。

选择建议：如果您是初学者或用于日常工作，建议选择 LTR 版本以获得最稳定的体验。如果您需要最新的功能特性，可以选择 Latest 版本。两个版本都支持并行安装，不会相互冲突。

2. Windows 安装步骤

Windows 是 QGIS 使用最广泛的平台，安装过程相对简单直接。

系统要求

  • 操作系统：Windows 10 64 位或更高版本
  • 硬盘空间：至少 5 GB 可用空间
  • 内存：建议 8 GB 以上（处理大型数据集建议 16 GB）
  • 处理器：支持 64 位的 x86_64 处理器

安装流程

  1. 从 下载页面 获取 Windows 安装包（MSI 格式）
  2. 双击下载的 .msi 文件启动安装程序
  3. 如果弹出用户账户控制提示，点击「是」允许安装
  4. 阅读并接受许可协议
  5. 选择安装类型：「完整安装」推荐大多数用户，「自定义安装」可选择性安装组件
  6. 选择安装路径：默认路径为 C:\Program Files\QGIS 3.x。建议保持默认路径，避免路径中包含中文字符（详见常见问题部分）
  7. 点击「安装」开始安装过程，等待进度条完成
  8. 安装完成后，勾选「启动 QGIS」并点击「完成」

3. macOS 安装步骤

macOS 上的 QGIS 安装方式与大多数 Mac 应用程序相同，但初次打开时可能需要额外的系统设置。

系统要求

  • 操作系统：macOS 12 Monterey 或更高版本
  • 处理器：支持 Intel 和 Apple Silicon（M1/M2/M3/M4）芯片
  • 硬盘空间：至少 5 GB 可用空间

安装流程

  1. 从 下载页面 获取 macOS 安装包（DMG 格式）
  2. 双击 .dmg 文件挂载磁盘镜像
  3. 在打开的 Finder 窗口中，将 QGIS 图标拖放到 Applications 文件夹
  4. 等待文件复制完成（约 2-5 分钟，取决于磁盘速度）
  5. 从 Applications 文件夹或 Launchpad 启动 QGIS

解决「无法打开 QGIS」的问题

首次打开 QGIS 时，macOS 可能会提示「无法打开 QGIS，因为无法验证开发者」。这是因为 QGIS 未通过 Apple 的公证认证。解决方法如下：

方法一：通过系统设置

  1. 尝试打开 QGIS，当出现错误提示时，记下提示信息
  2. 打开「系统设置」→「隐私与安全性」
  3. 在「安全性」部分找到被阻止的 QGIS 应用，点击「仍要打开」
  4. 在弹出的确认对话框中再次点击「打开」

方法二：使用终端命令

如果方法一无效，可以通过终端移除隔离属性：

sudo xattr -cr /Applications/QGIS.app

输入管理员密码后回车，然后重新打开 QGIS 即可。

4. Linux 安装步骤

Linux 上安装 QGIS 通常通过包管理器完成。以下以 Ubuntu/Debian 为例介绍安装方法。

Ubuntu/Debian 安装

安装 QGIS LTR 版本的命令如下：

sudo apt update
sudo apt install qgis qgis-plugin-grass

如果您需要安装最新版本的 QGIS，需要先添加官方软件源：

# 安装依赖
sudo apt install gnupg software-properties-common

# 添加 QGIS 签名密钥
wget -qO - https://qgis.org/downloads/qgis-2024.gpg.key | sudo gpg --no-default-keyring --keyring gnupg-ring:/etc/apt/trusted.gpg.d/qgis-archive.gpg --import

# 添加 QGIS 软件源
sudo add-apt-repository "deb https://qgis.org/ubuntu $(lsb_release -c -s) main"

# 更新并安装
sudo apt update
sudo apt install qgis qgis-plugin-grass

Fedora/CentOS 安装

sudo dnf install qgis qgis-grass

Arch Linux 安装

sudo pacman -S qgis

5. 安装后验证

安装完成后，建议进行以下检查以确保 QGIS 正常运行：

首次启动检查

  1. 启动 QGIS，等待初始化完成（首次启动可能需要 30 秒至 1 分钟）
  2. 观察界面是否正常显示，检查菜单栏、工具栏和面板是否完整
  3. 点击菜单「帮助」→「关于 QGIS」，确认版本号是否正确
  4. 关闭关于对话框后，尝试添加一个示例图层或在线地图，验证基本功能

检查 Python 环境

QGIS 依赖 Python 运行插件和处理脚本。您可以通过以下方式检查 Python 是否正常工作：

  1. 打开菜单「插件」→「Python 控制台」
  2. 在控制台中输入 print("QGIS Python OK") 并回车
  3. 如果输出 QGIS Python OK，说明 Python 环境正常

6. 常见安装问题解决

以下汇总了国内用户在安装 QGIS 时最常遇到的问题及解决方案。

Windows：错误代码 2503/2502

安装 MSI 文件时提示错误 2503 或 2502，通常是由于安装权限不足导致。

解决方法：以管理员身份运行安装程序。右键点击 MSI 文件，选择「以管理员身份运行」。或者打开命令提示符（管理员），使用命令安装：

msiexec /i "C:\path\to\QGIS-Installer.msi"

Windows：缺少 DLL 文件

启动时提示缺少 api-ms-win-*.dll 或其他 DLL 文件，通常是因为系统版本过低。

解决方法：确保您的 Windows 10 已安装最新更新。检查并安装所有 Windows Update 可选更新，特别是 Visual C++ 运行库。

安装路径包含中文字符

如果 QGIS 安装在路径包含中文的目录下（如 C:\程序\QGIS），可能导致部分功能异常，尤其是 Python 插件和 Processing 工具箱。

解决方法：卸载 QGIS，重新安装到纯英文路径下，如 C:\Program Files\QGIS 3.44。同样注意项目文件和数据文件路径也应避免中文字符。

macOS：QGIS 图标上有禁止标志

这表示 QGIS 与当前 macOS 版本不兼容。

解决方法：请确认下载的 QGIS 版本与您的 macOS 版本匹配。Intel 芯片的 Mac 请下载 x86_64 版本，Apple Silicon 芯片请下载 arm64 版本（Universal 版本同时支持两种芯片）。

Linux：版本过旧

通过 apt install qgis 安装的版本可能非常旧，不是最新的 LTR 版本。

解决方法：参照第 4 节中的步骤添加 QGIS 官方软件源后再安装，这样可以获取最新版本。

如果以上内容未能解决您的安装问题，请访问我们的 常见问题 页面，或在社区中寻求帮助。安装完成后，推荐阅读 QGIS 入门教程 开始您的学习之旅。