【Qt专栏】实现单例程序，禁止程序多开的几种方式

目录

一，简要介绍

二，实现示例（Windows）

1.使用系统级别的互斥机制

2.通过共享内存（进程间通信-IPC）

3.使用命名互斥锁（不推荐）

4.使用文件锁

5.通过网络端口检测

---

一，简要介绍

前言

• 禁止程序多开，也称为“单实例应用程序”或“单例应用程序”，是指通过各种手段防止同一个应用程序同时运行多个实例。这种方法可以提升应用程序的稳定性、资源利用效率和用户体验。

目的

• 禁止程序多开的主要目的是确保应用程序在同一时刻只能运行一个实例，防止资源浪费、数据冲突、混淆等问题，以提高应用程序的质量和用户满意度。

好处

1. 资源管理：多个实例同时运行可能导致资源的浪费，如内存、CPU 使用率等。通过限制只能运行一个实例，可以更有效地管理系统资源。
2. 数据一致性：如果应用程序涉及到对共享数据或状态的修改，多个实例同时运行可能会导致数据不一致的问题。通过禁止多开，可以避免这种情况。
3. 减少冲突：多个实例可能尝试访问同一资源，如文件、数据库等，导致冲突和错误。禁止多开可以减少这种情况的发生。
4. 避免混淆：如果应用程序依赖于特定的硬件或外部设备，多个实例可能会导致设备混淆或竞争，从而影响功能正常运行。
5. 提升用户体验：当用户只期望运行一个实例时，多开可能会让用户感到困惑。通过禁止多开，可以提升用户的体验和易用性。

实现方式

1. 系统级别互斥机制：使用操作系统提供的互斥机制，如命名互斥体等。
2. 共享内存或命名管道：使用共享内存或命名管道在不同实例间进行通信，防止多开。
3. 命名互斥锁或文件锁：创建一个唯一名称的互斥锁或文件锁，如果已经存在，表示已有实例运行。
4. 网络端口检测：尝试绑定到一个特定的网络端口，如果绑定成功，则表示没有其他实例在运行。
5. 环境变量检测：检查环境变量，如已设置则表示已有实例运行。

总结

• 总之，禁止程序多开是一种优化应用程序的方法，可以确保应用程序在不同环境中稳定、高效地运行。选择适合的实现方式取决于应用程序的需求和技术栈。

二，实现示例（Windows）

1.使用系统级别的互斥机制

• 某些操作系统提供了系统级别的互斥机制，可以防止同一应用程序的多个实例运行。例如，Windows 提供了命名互斥体来实现这一点。
• 示例模板​​​​​​​​​​​​​​
• 示例代码

#include "mainwindow.h"
#include 
#include 
#include 

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);

    // L"字符串"：表示将ANSI字符串转换成unicode的字符串，使每个字符占两个字节
    HANDLE hMutex = CreateMutex(nullptr, TRUE, (LPCWSTR)qApp->applicationName().toStdWString().c_str());
    if (GetLastError() == ERROR_ALREADY_EXISTS) {
        QMessageBox::warning(nullptr, "Error", "An instance of the application is already running.");
        CloseHandle(hMutex);
        hMutex = NULL;
        return 1;
    }

    // 在此处写你的应用程序逻辑代码
    MainWindow w;
    w.show();
    a.exec();

    // 完成后关闭互斥锁
    CloseHandle(hMutex);
    hMutex = NULL;
    return 0;
}

2.通过共享内存（进程间通信-IPC）

• 使用进程间通信技术，例如共享内存，来检测是否已经有一个实例在运行。
• 示例模板（使用 Qt 的 QSharedMemory 进行进程间通信）​​​​​​​
• 示例代码

#include "mainwindow.h"
#include 
#include 
#include 

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);

    QSharedMemory sharedMemory(qApp->applicationName());    // 设置绑定的共享内存段的key值
    if(sharedMemory.attach()){
        QMessageBox::warning(nullptr, "Error", "An instance of the application is already running.");
        return 1;
    }else{
        sharedMemory.create(1); // 创建1byte大小的共享内存段
    }

    // 在此处写你的应用程序逻辑代码
    MainWindow w;
    w.show();
    a.exec();

    // 完成后分离共享内存
    sharedMemory.detach();
    return 0;
}

3.使用命名互斥锁（不推荐）

• 在应用程序启动时创建一个命名互斥锁，确保只有一个实例可以获取锁，其他实例将被阻止。
• 示例模板
• 示例代码

#include "mainwindow.h"
#include 
#include 
#include 

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);

    // 声明一个命名互斥锁，用于防止多开
    QSystemSemaphore semaphore(qApp->applicationName(), 1, QSystemSemaphore::Open);

    if (!semaphore.acquire()) {
        QMessageBox::warning(nullptr, "Error", "An instance of the application is already running.");
        return 1;
    }

    // 在此处写你的应用程序逻辑代码
    MainWindow w;
    w.show();
    a.exec();

    // 释放互斥锁，允许其他实例运行
    semaphore.release();
    return 0;
}

4.使用文件锁

• 在应用程序启动时创建一个特定的文件锁，如果锁已存在，则表示已经有一个实例在运行。
• 示例模板​​​​​​​

• 示例代码

#include "mainwindow.h"
#include 
#include 
#include 

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);

    QFile lockFile(qAppName() +".lock");
    if (lockFile.exists()) {
        QMessageBox::warning(nullptr, "Error", "An instance of the application is already running.");
        return 1;
    }

    lockFile.open(QIODevice::WriteOnly);
    lockFile.write("Running"); // 向锁文件写入一些数据
    lockFile.close();

    // 在此处写你的应用程序逻辑代码
    MainWindow w;
    w.show();
    a.exec();

    // 完成后删除锁定文件
    lockFile.remove();
    return 0;
}

5.通过网络端口检测

• 在应用程序启动时尝试绑定到一个特定的网络端口，如果绑定成功，则表示没有其他实例正在运行。
• 示例模板
• 示例代码

#include "mainwindow.h"
#include 
#include 
#include 

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);

    QTcpServer tcpServer;
    if (!tcpServer.listen(QHostAddress::LocalHost, 12345)) {
        QMessageBox::warning(nullptr, "Error", "An instance of the application is already running.");
        return 1;
    }

    // 在此处写你的应用程序逻辑代码
    MainWindow w;
    w.show();
    a.exec();

    // 完成后关闭服务器
    tcpServer.close();
    return 0;
}