Qt Creator构建QGroundControl时Git参数异常报错求助

安全阿岳

2026-8-12

构建QGroundControl时Git命令异常问题

在Qt Creator中构建QGroundControl的qgroundcontrol.pro文件时，「Issues」栏出现如下Git错误提示：

unknown option: -
usage: git [-v | --version] [-h | --help] [-C ] [-c =]
[--exec-path[=]] [--html-path] [--man-path] [--info-path]
[-p | --paginate | -P | --no-pager] [--no-replace-objects] [--bare]
[--git-dir=] [--work-tree=] [--namespace=]
[--super-prefix=] [--config-env==]
[]

推测是Git文件读取失败导致构建异常，已查阅Qt Creator和QGroundControl官方文档未找到解决办法，求同类问题的解决方案。

可能的解决方向

检查Git环境变量配置
确保系统PATH环境变量包含Git的正确安装路径，路径中避免空格或特殊字符。终端执行git --version验证Git是否正常调用，若终端正常但Qt Creator异常，重启Qt Creator重新加载环境变量。
排查.pro文件中的Git脚本
打开qgroundcontrol.pro，查找调用Git的代码段（比如获取版本信息的逻辑），检查是否存在错误参数传递（比如多余的短横线-）。这类错误通常是脚本拼接Git命令时出现语法问题，比如误写git - ...这类格式错误的命令。
验证Git仓库完整性
在QGroundControl根目录执行git status确认仓库状态，若.git文件夹损坏，重新克隆完整仓库：
```
git clone --recursive https://github.com/mavlink/qgroundcontrol.git
```
调整Qt Creator构建环境
进入Qt Creator「工具」→「选项」→「构建和运行」→「构建环境」，手动添加Git路径到环境变量，或直接指定Git完整执行路径（如Windows下C:\Program Files\Git\bin\git.exe，Linux下/usr/bin/git）。