如何在Qt应用构建时执行Git命令并将提交ID嵌入UI

没问题！完全可以实现这个需求——你有两种主流方式来获取Git提交ID并嵌入到QtQuick应用的UI中，分别是编译时通过.pro文件预获取（更适合发布版本）和运行时通过C++代码执行Git命令。结合你的Qt 5.9.3和MacOS High Sierra环境，我给你详细拆解两种方案：

这种方式在编译阶段就把Git提交ID嵌入到程序中，不需要依赖运行环境的Git，非常适合发布版本使用。

步骤1：在QtApp.pro中添加Git命令逻辑 #

利用qmake的$$system()函数执行Git命令，将结果转为预编译宏供C++代码调用：

# 获取Git短提交ID（--short参数可以生成更简洁的7位ID，去掉则获取完整ID）
GIT_COMMIT_ID = $$system(git rev-parse --short HEAD)

# 处理Git命令执行失败的情况（比如不在Git仓库、Git未安装）
isEmpty(GIT_COMMIT_ID) {
    GIT_COMMIT_ID = "unknown"
}

# 定义预编译宏，让C++代码可以直接访问
DEFINES += GIT_COMMIT_ID=\\\"$$GIT_COMMIT_ID\\\"

步骤2：在main.cpp中传递提交ID到QML #

把预编译的提交ID作为上下文属性传递给QML界面：

#include <QGuiApplication>
#include <QQmlApplicationEngine>
#include <QString>

int main(int argc, char *argv[])
{
    QGuiApplication app(argc, argv);

    QQmlApplicationEngine engine;
    // 将提交ID注入QML上下文
    engine.rootContext()->setContextProperty("gitCommitId", QString(GIT_COMMIT_ID));

    engine.load(QUrl(QStringLiteral("qrc:/main.qml")));
    if (engine.rootObjects().isEmpty())
        return -1;

    return app.exec();
}

步骤3：在QML中显示提交ID #

直接调用上下文属性展示内容：

import QtQuick 2.9
import QtQuick.Window 2.2

Window {
    visible: true
    width: 640
    height: 480
    title: qsTr("Qt App Version")

    Text {
        anchors.centerIn: parent
        text: qsTr("Release Commit: %1").arg(gitCommitId)
        font.pixelSize: 16
    }
}

这种方式在程序启动时动态执行Git命令获取提交ID，适合需要实时获取最新提交的场景，但依赖用户环境已安装Git。

步骤1：在main.cpp中编写Git命令执行逻辑 #

使用QProcess调用系统Git命令并解析输出：

#include <QGuiApplication>
#include <QQmlApplicationEngine>
#include <QProcess>
#include <QString>

// 封装获取Git提交ID的函数
QString getGitCommitId() {
    QProcess gitProcess;
    // 执行git rev-parse --short HEAD命令
    gitProcess.start("git", QStringList() << "rev-parse" << "--short" << "HEAD");
    gitProcess.waitForFinished();

    // 读取命令输出并去除多余换行/空格
    QString commitId = gitProcess.readAllStandardOutput().trimmed();
    // 处理执行失败的情况
    if (commitId.isEmpty()) {
        commitId = "unknown";
    }
    return commitId;
}

int main(int argc, char *argv[])
{
    QGuiApplication app(argc, argv);

    QQmlApplicationEngine engine;
    QString commitId = getGitCommitId();
    engine.rootContext()->setContextProperty("gitCommitId", commitId);

    engine.load(QUrl(QStringLiteral("qrc:/main.qml")));
    if (engine.rootObjects().isEmpty())
        return -1;

    return app.exec();
}

步骤2：QML显示部分与方案一完全一致 #

直接使用gitCommitId属性即可展示提交ID。

注意事项（针对MacOS环境） #

• 确保Git已加入系统PATH，Qt Creator的终端环境能正常调用git命令（默认MacOS自带Git，一般无需额外配置）。
• 若使用CI环境编译，需确保CI环境已安装Git，且仓库为完整克隆（浅克隆可能导致rev-parse命令失效）。
• 发布版本优先选择方案一，避免用户机器未安装Git导致提交ID无法获取。

内容的提问来源于stack exchange，提问作者TheWaterProgrammer