第1章:QGC下载与安装——三平台实战指南

大家好,我是老张。做无人机地面站开发这些年,我见过太多新手在安装QGC这一步就卡住了。说实话,安装本身并不难,但不同系统下的坑确实不少。今天我就手把手带你把QGC装好,顺便分享一些我踩过的坑。

核心要点:QGC(QGroundControl)是一款跨平台地面站软件,支持Windows、macOS和Linux。安装前请确保你的系统满足最低要求:4GB内存、2GHz处理器、支持OpenGL 3.3+的显卡。

QGC安装流程总览 Windows系统 .exe安装包 / 便携版 macOS系统 .dmg镜像 / Homebrew Linux系统 AppImage / 源码编译 ⚠ 共同步骤:下载 → 安装 → 启动 → 配置串口权限 建议优先选择官方稳定版,避免使用每日构建版

一、Windows系统下的安装

Windows用户是最多的,安装也最直接。我个人习惯用安装包版,因为省心。

  1. 下载安装包:访问QGC官网(qgroundcontrol.com),点击「Download for Windows」。你会看到两个选项:稳定版(Stable)和每日构建版(Daily Build)。我建议选稳定版,除非你需要尝鲜新功能。
  2. 运行安装程序:双击下载的QGroundControl-installer.exe。嗯,这里要注意——Windows可能会弹出「Windows protected your PC」的警告。别慌,点击「More info」然后「Run anyway」就行。这是微软的SmartScreen在作怪,QGC是开源软件,没问题的。
  3. 选择安装路径:默认路径是C:\Program Files\QGroundControl。我个人习惯改到D盘,避免C盘空间不足。你随意。
  4. 等待安装完成:大概1-2分钟。完成后桌面会出现QGC图标。

小技巧:如果你不想安装,可以用便携版(Portable)。下载QGroundControl.exe直接运行,连安装都省了。我在客户现场演示时经常用这个版本,即插即用。

注意:Windows系统下,QGC需要安装VC++ Redistributable运行库。如果启动时报错「VCRUNTIME140.dll缺失」,去微软官网下载安装即可。我曾经在客户电脑上折腾了半小时才发现是这个问题。

二、macOS系统下的安装

macOS用户相对少一些,但安装起来也不复杂。我记得第一次在Mac上装QGC时,还因为权限问题卡了半天。

  1. 下载.dmg文件:官网选择「Download for macOS」。下载的是QGroundControl.dmg镜像文件。
  2. 安装应用:双击.dmg文件,把QGC图标拖到「Applications」文件夹。就这么简单。
  3. 处理安全提示:第一次启动时,macOS会提示「QGroundControl is from an unidentified developer」。这是因为QGC没有苹果开发者签名。解决方法:去「系统偏好设置 → 安全性与隐私 → 通用」,点击「仍要打开」。
  4. 授予权限:QGC需要访问串口和网络权限。启动时会弹出请求,记得点「允许」。否则连不上飞控。

避坑指南:我曾经在macOS 13 Ventura上遇到过QGC闪退的问题。后来发现是系统版本兼容性问题。解决办法:右键QGC图标 → 显示简介 → 勾选「使用Rosetta打开」。这样就能兼容运行了。

三、Linux系统下的安装

Linux安装稍微麻烦点,但自由度最高。我平时开发用的就是Ubuntu 22.04,所以对这个流程很熟。

方法一:AppImage(推荐新手)

  1. 下载QGroundControl.AppImage文件
  2. 赋予执行权限:chmod +x QGroundControl.AppImage
  3. 直接运行:./QGroundControl.AppImage

你看,就这么三行命令。AppImage的好处是无需安装,一个文件搞定所有依赖。

方法二:源码编译(进阶用户)

如果你需要定制功能,或者想学习QGC的架构,可以自己编译。步骤如下:

# 安装依赖
sudo apt-get install build-essential cmake qt5-default libqt5serialport5-dev \
  libqt5opengl5-dev libqt5svg5-dev libqt5quick5 libqt5quickcontrols2-5 \
  libqt5quickwidgets5 qtdeclarative5-dev qtpositioning5-dev \
  libqt5sql5-sqlite libqt5xml5 libqt5network5 libqt5gui5

# 克隆源码
git clone https://github.com/mavlink/qgroundcontrol.git
cd qgroundcontrol

# 编译
mkdir build && cd build
cmake ..
make -j4

# 运行
./QGroundControl

注意:Linux下最容易出问题的是串口权限。如果你插上飞控后QGC识别不到,八成是权限问题。解决方法:把当前用户加入dialout组:sudo usermod -a -G dialout $USER,然后注销重新登录。我当年第一次用Linux时,这个问题困扰了我整整一个下午。

四、安装后的验证

装完之后,怎么知道装对了?我一般做三步检查:

检查项 方法 正常结果
启动检查 双击QGC图标 出现主界面,无报错
版本检查 菜单栏 Help → About 显示版本号(如4.2.0)
串口检查 连接飞控,看左上角 显示「Connected」

我的习惯:装好后先不连飞控,打开模拟模式(Settings → General → Simulate)。这样可以在没有硬件的情况下熟悉界面。我教新人时都让他们先玩两天模拟器再上真机。

好了,三个平台的安装方法都讲完了。说实话,安装只是第一步,后面配置参数才是重头戏。但基础打牢了,后面就顺了。如果你在安装过程中遇到任何问题,欢迎交流。


可可精品资料库