必须加global前缀,因为windows默认创建会话级mutex,不加则无法跨远程桌面、锁屏重登录等不同会话唯一标识;加后才实现全系统唯一,但需确保有secreateglobalprivilege权限。

直接用 Mutex 就行,但必须带 Global 前缀、显式检查 createdNew 或调用 WaitOne,否则在多用户会话或 Windows 服务环境下大概率失效。
为什么 Mutex 名称一定要加 Global 前缀
Windows 默认创建的是会话级(Session-scoped)互斥体,同一用户的不同登录会话(比如远程桌面、锁屏后重新登录)会各自拥有独立的命名空间。不加 Global,两个同名但不同会话的实例照样能同时跑起来。
加了 Global 才真正跨会话唯一——前提是当前进程有 SeCreateGlobalPrivilege 权限(普通桌面应用默认有;Windows 服务需显式配置)。
-
"MyAppMutex"→ 仅当前会话内唯一 -
"Global\MyAppMutex"→ 全系统唯一(推荐) -
"Local\MyAppMutex"→ 显式声明会话级,意义不大,少用
Mutex(bool initiallyOwned, string name, out bool createdNew) 的坑
这个构造函数看似方便,但 createdNew 为 false 只代表“该名称的 Mutex 已存在”,不代表它正被另一个实例持有——比如上一个实例崩溃退出时没释放 Mutex,系统会标记为已放弃(AbandonedMutexException),此时新实例仍能拿到所有权。
所以不能只靠 !createdNew 就直接退出,得配合异常捕获:
bool createdNew;
using (var mutex = new Mutex(true, "Global\MyApp", out createdNew))
{
if (!createdNew)
{
try
{
// 尝试获取,超时设为 0 避免阻塞
if (!mutex.WaitOne(0))
{
Console.WriteLine("程序已在运行中");
return;
}
}
catch (AbandonedMutexException)
{
// 被遗弃,当前线程已自动获得所有权,继续执行
}
}
// 主逻辑...
}
WinForms 应用唤醒已有窗口而不是退出
只阻止启动不够,用户双击图标时更希望把已有窗口带到前台。这需要两步:先用 Mutex 判重,再用 Win32 API 激活主窗口。
- 确保主窗体设置了
Text属性(比如this.Text = "MyApp"),这是FindWindow的查找依据 - 用
FindWindow(null, "MyApp")获取句柄,比遍历同名进程更可靠(避免匹配到其他同名后台进程) - 调用
ShowWindowAsync和SetForegroundWindow,注意后者在 Windows 10/11 上受前台激活策略限制,可能需要AllowSetForegroundWindow
关键点:Mutex 判重和窗口激活是两个独立动作,别混在同一个 try 块里——前者失败才该退出,后者失败不影响程序启动。
调试时重复启动导致 Mutex 卡死怎么办
Visual Studio 默认按 F5 启动调试时,若上一次调试异常终止,Mutex 可能处于遗弃状态。下次启动时若没处理 AbandonedMutexException,WaitOne 会直接抛异常并中断流程。
开发阶段建议:
- 在
Main方法开头加#if DEBUG条件编译,跳过 Mutex 检查 - 或者用随机后缀生成 Mutex 名(如
"Global\MyApp_" + Guid.NewGuid()),仅用于调试 - 正式发布前务必删掉或禁用这些绕过逻辑
真正容易被忽略的是:Mutex 名称拼写错误、大小写敏感、反斜杠漏转义——这些都不会报错,只会让判重完全失效。每次改名后,最好用 Process Explorer 查下 “Objects” 标签页里是否真创建出了对应名称的全局对象。











