QtApplets-实现应用程序单例模式，防止重复运行

2025/4/19 22:03:06 来源：https://blog.csdn.net/z609932088/article/details/147306456 浏览: 次关键词：QtApplets-实现应用程序单例模式，防止重复运行

QtApplets-实现应用程序单例模式，防止重复运行

文章目录

QtApplets-实现应用程序单例模式，防止重复运行
摘要
引言
实现原理
核心代码实现
头文件定义
实现文件

使用方法
技术要点解析
1. 文件锁机制
2. 进程 ID 管理
3. Windows 互斥量
4. 跨平台兼容

注意事项
实际应用场景
☞ 源码

关键字： Qt、单例模式、QLockFile、进程管理、跨平台

摘要

本文将详细介绍如何在 Qt 应用程序中实现单例模式，确保应用程序只能运行一个实例。通过文件锁、进程 ID 和互斥量等多种机制，实现了一个健壮的单例模式解决方案。

引言

在开发桌面应用程序时，我们经常需要确保应用程序只能运行一个实例。比如，当用户尝试重复启动程序时，我们应该提示用户程序已经在运行，而不是启动新的实例。本文将介绍如何在 Qt 中实现这一功能。

实现原理

我们的单例模式实现采用了多重保护机制：

文件锁机制：使用 QLockFile 创建锁文件
进程 ID 记录：保存当前运行实例的进程 ID
互斥量机制：Windows 系统下额外使用系统互斥量
进程存活检测：验证已存在进程是否真实运行

核心代码实现

头文件定义

class SingleInstance : public QObject {Q_OBJECT
public:explicit SingleInstance(const QString& appKey, QObject* parent = nullptr);~SingleInstance();bool isRunning();  // 返回true表示已有实例运行void killExisting(); // 强制终止已有实例private:bool isProcessAlive(qint64 pid);qint64 readPidFromFile();void writeCurrentPid();void cleanup();QString m_lockFilePath;QString m_pidFilePath;#ifdef Q_OS_WINHANDLE m_hMutex = nullptr;
#endif
};

实现文件

SingleInstance::SingleInstance(const QString& appKey, QObject* parent): QObject(parent)
{// 构造唯一文件路径QString tempDir = QStandardPaths::writableLocation(QStandardPaths::TempLocation);m_lockFilePath = tempDir + "/" + appKey + ".lock";m_pidFilePath = tempDir + "/" + appKey + ".pid";#ifdef Q_OS_WIN// Windows额外使用互斥量m_hMutex = CreateMutexW(NULL, TRUE, (L"Global\\" + appKey.toStdWString()).c_str());if (GetLastError() == ERROR_ALREADY_EXISTS) {ReleaseMutex(m_hMutex);CloseHandle(m_hMutex);m_hMutex = nullptr;}
#endif
}

使用方法

在应用程序的 main.cpp 中，我们只需要添加几行代码即可实现单例模式：

int main(int argc, char *argv[])
{// 使用应用名称作为唯一标识SingleInstance guard("YourAppName_Company");if (guard.isRunning()) {QMessageBox::warning(nullptr, "警告", "程序已在运行中");guard.killExisting(); // 可选：强制终止已有实例}QApplication a(argc, argv);Widget w;w.show();return a.exec();
}