最直接有效的方式是创建命名互斥量,首个进程成功创建并持有,后续进程调用createmutex时因名称已存在而返回error_already_exists,从而实现单实例控制。

Windows下用CreateMutex防止多开
最直接有效的方式是创建一个命名互斥量(CreateMutex),靠系统内核对象保证全局唯一性。只要名字相同,第二个进程调用CreateMutex时会拿到已存在的句柄,且GetLastError()返回ERROR_ALREADY_EXISTS。
注意点:
-
CreateMutex第一个参数设为NULL(无安全描述符),第三个参数给个**全局唯一、稳定不变**的名字,比如"MyApp_SingleInstance_12345678",避免和其他程序冲突 - 必须在程序启动最早期调用(比如
main()开头),否则可能刚创建窗口或加载DLL时就已被其他实例抢先占位 - 不要忘记调用
CloseHandle释放句柄——但别在检测到重复后立刻关掉,否则后续判断会失效;建议只在单实例成功运行后才关闭 - 如果程序异常退出,系统会自动清理互斥量,不用担心残留,但不要依赖这点做逻辑判断
Linux/macOS用文件锁实现单例
没有Windows那样的内核互斥量,通用做法是用open()配合O_EXCL | O_CREAT标志尝试创建一个带固定路径的锁文件(如/tmp/myapp.lock)。成功创建即获得锁;失败则说明已有实例在运行。
关键细节:
- 锁文件路径必须可写且跨会话一致,推荐
/tmp/或$XDG_RUNTIME_DIR(需先检查环境变量) - 务必用
flock()或fcntl(F_SETLK)加建议锁——仅靠文件存在与否不可靠(进程崩溃后残留文件会导致误判) - 写入当前进程PID到锁文件,便于调试时排查谁占着锁;但读取并kill旧进程属于额外逻辑,不建议默认启用
- 程序退出前要显式
unlink()锁文件,并确保所有出口路径(包括std::exit、信号处理、异常逃逸)都覆盖到
跨平台方案:Boost.Interprocess或Qt自带机制
如果项目已用Qt,直接上QSharedMemory + QLocalSocket组合,或更简单的QtSingleApplication(注意它已从Qt5.15起移除,需自行维护或换用qt-solutions分支)。
用Boost的话,boost::interprocess::named_mutex在Windows和POSIX系统上行为一致,封装了底层差异:
- 构造时传入唯一名称,
try_lock()失败即表示已有实例 - 不需要手动清理——析构时自动释放,但要求对象生命周期贯穿整个程序运行期
- Boost版本需≥1.50,且编译时要链接
-lboost_system - 注意Boost.Interprocess在macOS上某些版本有
sem_open权限问题,可改用file_lock回退路径
用户看到“程序已运行”该怎么响应
单纯退出太粗暴。更友好的做法是把新启动的参数通过IPC(如Windows的SendMessage、Unix域套接字)转给已有实例,再让老进程激活窗口或打开新文档。
实操要点:
- Windows下可用
FindWindow+PostMessage唤醒主窗口,消息类型自定义(如WM_USER + 100),附带命令行参数指针(需共享内存或注册窗口消息) - Linux下推荐
AF_UNIX套接字,服务端由首个实例监听,客户端连上后发送argv数据,然后exit(0) - 别在新进程里等应答——万一老进程卡死,会导致新进程挂起;超时设为500ms足够
- 如果老进程没响应,再优雅退出,并提示“主程序未响应,请检查是否卡死”
真正的难点不在创建锁,而在清理时机和IPC健壮性。尤其当用户强制杀进程、断电、或容器被OOM killer干掉时,锁状态可能错乱——这时候宁可多一次误判,也别让两个实例同时写同一份配置文件。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











