在C#桌面应用开发中,防止程序多开是很多场景下需要实现的功能,比如工具类软件、客户端程序等,多开可能会导致数据处理冲突、系统资源占用过高的问题。使用Mutex互斥锁是实现单实例运行的经典方案,通过系统层面的互斥机制判断程序是否已经启动,但是实际实现过程中有不少细节需要注意,否则会出现判断失效、程序异常退出后无法再次启动等问题。

C# Mutex实现单实例运行的基础实现
Mutex是操作系统提供的同步基元,可以用来控制多个进程对共享资源的访问,我们可以利用这个特性判断当前程序是否有其他实例在运行。基础的实现逻辑是在程序启动时创建一个指定名称的Mutex,如果创建成功说明没有其他实例运行,如果创建失败说明已经有实例在运行,此时直接退出程序即可。
下面是控制台程序的基础实现示例:
using System;
using System.Threading;
class Program
{
private static Mutex mutex = null;
static void Main(string[] args)
{
// 定义互斥锁的名称,建议使用唯一的GUID或者程序专属标识,避免和其他程序冲突
string mutexName = "Global\MyApp_Unique_Mutex_123456";
bool createdNew;
// 尝试创建互斥锁,createdNew为true表示创建成功,即没有其他实例运行
mutex = new Mutex(true, mutexName, out createdNew);
if (!createdNew)
{
// 已经有实例运行,输出提示并退出
Console.WriteLine("程序已经在运行中,无法再次启动");
Console.ReadLine();
return;
}
// 程序正常运行的逻辑
Console.WriteLine("程序启动成功,按任意键退出");
Console.ReadLine();
// 释放互斥锁
mutex.ReleaseMutex();
}
}
实现过程中的常见避坑要点
1. 互斥锁命名要规范
互斥锁的名称是全局唯一的,如果命名过于简单,比如直接使用MyAppMutex,可能会和其他程序的互斥锁名称冲突,导致判断逻辑出错。建议在名称前加上Global\前缀,让互斥锁在全局命名空间中生效,同时名称中使用程序的唯一标识,比如GUID、程序集名称等,避免和其他程序冲突。
2. 正确处理未释放的互斥锁
如果程序异常退出,没有执行ReleaseMutex方法,系统会自动释放该进程持有的互斥锁,但是如果是正常退出,一定要手动调用ReleaseMutex释放,否则可能会导致互斥锁一直被占用,后续无法启动程序。另外,创建Mutex时第一个参数传入true,表示当前线程初始拥有互斥锁的所有权,这样后续释放的时候才不会出现权限问题。
3. 避免重复释放互斥锁
如果多次调用ReleaseMutex方法,会抛出ApplicationException异常。可以在释放前判断互斥锁是否已经被释放,或者使用try-finally块确保释放逻辑只执行一次,示例代码如下:
using System;
using System.Threading;
class Program
{
private static Mutex mutex = null;
static void Main(string[] args)
{
string mutexName = "Global\MyApp_Unique_Mutex_123456";
bool createdNew;
try
{
mutex = new Mutex(true, mutexName, out createdNew);
if (!createdNew)
{
Console.WriteLine("程序已经在运行中");
return;
}
Console.WriteLine("程序启动成功,按任意键退出");
Console.ReadLine();
}
finally
{
if (mutex != null && createdNew)
{
mutex.ReleaseMutex();
mutex.Dispose();
}
}
}
}
4. 处理已有实例时的用户提示
如果是窗体程序,当检测到已有实例运行时,不要直接退出,可以先找到已经运行的实例窗口,将其激活并显示到前台,提升用户体验。可以通过Process类获取当前运行的所有进程,找到同名的进程后,调用Windows API将其窗口前置,示例代码如下:
using System;
using System.Diagnostics;
using System.Runtime.InterServices;
using System.Threading;
class Program
{
[DllImport("user32.dll")]
private static extern bool SetForegroundWindow(IntPtr hWnd);
[DllImport("user32.dll")]
private static extern bool ShowWindowAsync(IntPtr hWnd, int nCmdShow);
private const int SW_RESTORE = 9;
private static Mutex mutex = null;
static void Main(string[] args)
{
string mutexName = "Global\MyApp_Unique_Mutex_123456";
bool createdNew;
mutex = new Mutex(true, mutexName, out createdNew);
if (!createdNew)
{
// 找到已经运行的实例,将其窗口激活
Process currentProcess = Process.GetCurrentProcess();
foreach (Process process in Process.GetProcessesByName(currentProcess.ProcessName))
{
if (process.Id != currentProcess.Id)
{
ShowWindowAsync(process.MainWindowHandle, SW_RESTORE);
SetForegroundWindow(process.MainWindowHandle);
break;
}
}
return;
}
// 程序正常运行逻辑
Console.WriteLine("程序启动成功");
Console.ReadLine();
mutex.ReleaseMutex();
}
}
不同程序类型的适配说明
对于WPF或者WinForms窗体程序,上述逻辑同样适用,只需要在程序的入口处(比如Application_Startup或者Main方法)添加互斥锁判断逻辑即可。如果是服务类程序,不需要处理窗口激活的逻辑,直接判断互斥锁状态后决定是否启动服务即可。
另外需要注意,Mutex是跨会话的,如果程序需要在多个用户会话下都只能运行一个实例,命名时加上Global\前缀就可以实现,如果只需要在当前用户会话下单实例运行,可以去掉Global\前缀。