C#实现单实例应用程序：确保程序唯一运行实例_c# 判断进程,只能启动一个实例后台激活-CSDN博客

本文链接：https://blog.csdn.net/huyu107/article/details/148303395

C#实现单实例应用程序：确保程序唯一运行实例

在开发桌面应用程序时，我们经常需要确保程序同一时间只运行一个实例。无论是为了避免资源竞争、保持用户界面状态统一，还是提升系统资源利用效率，单实例应用都是一个常见需求。本文将介绍如何通过 C# 代码实现单实例应用程序，并提供完整的工具类实现与使用示例。

一、核心代码解析

我们首先来看实现单实例检查的核心工具类ProcessSingleton，代码基于System.Diagnostics.Process和 Windows API 实现：

using System;
using System.Diagnostics;
using System.Runtime.Interopservices;

public static class ProcessSingleton
{
   /// <summary>
   /// 获取已存在的同名进程实例
   /// </summary>
   /// <returns>已存在的进程实例或null</returns>
   public static Process GetInstance()
   {
       var currentProcess = Process.GetCurrentProcess();
       // 获取所有同名进程
       var processes = Process.GetProcessesByName(currentProcess.ProcessName);
      
       foreach (var p in processes)
       {
           // 跳过当前进程自身
           if (p.Id != currentProcess.Id)
           {
               return p; // 找到已存在的实例
           }
       }
       return null; // 未找到其他实例
   }

   /// <summary>
   /// 激活并显示目标进程窗口
   /// </summary>
   /// <param name="instance">目标进程实例</param>
   public static void DisplayInstance(Process instance)
   {
       const int SW_SHOWNOMAL = 1; // 正常显示窗口
       // 调用Windows API显示窗口并设置前台
       ShowWindowAsync(instance.MainWindowHandle, SW_SHOWNOMAL);
       SetForegroundWindow(instance.MainWindowHandle);
   }

   // 封装Windows API调用
   private static class User32
   {
       [DllImport("User32.dll")]
       public static extern bool ShowWindowAsync(IntPtr hWnd, int cmdShow);

       [DllImport("User32.dll")]
       public static extern bool SetForegroundWindow(IntPtr hWnd);
   }
}

关键方法说明：

GetInstance()

通过Process.GetCurrentProcess()获取当前运行的进程实例
使用Process.GetProcessesByName()获取所有同名进程（包括当前进程）
遍历进程列表，通过 ID 对比找到第一个非当前进程的实例（即已存在的实例）
若未找到返回 null，表示这是第一个运行实例

DisplayInstance()

使用 Windows API 中的ShowWindowAsync和SetForegroundWindow
前者负责按指定方式显示窗口（这里使用正常显示模式SW_SHOWNOMAL）
后者将窗口设置为前台活动窗口，确保用户可见
通过MainWindowHandle获取进程主窗口句柄，需注意可能为 null 的情况（如控制台程序）

User32 静态类

通过DllImport特性导入 User32.dll 中的 API
实现对 Windows 原生窗口操作函数的封装

二、应用场景与使用方法

典型应用场景：

桌面工具软件：如文件管理器、即时通讯工具
后台服务程序：需要避免重复启动的守护进程
资源敏感型应用：如数据库管理工具，防止多重连接占用资源
状态统一型应用：需要保持全局状态一致的 IDE 或设计工具

在 WinForms/WPF 中的使用步骤：

在程序入口检查实例（以 WinForms 为例，修改 Program.cs）：

static class Program
{
   [STAThread]
   static void Main()
   {
       // 检查是否已有实例运行
       var existingProcess = ProcessSingleton.GetInstance();
      
       if (existingProcess != null)
       {
           // 激活已有窗口并退出当前进程
           ProcessSingleton.DisplayInstance(existingProcess);
           return;
       }

       // 正常启动程序
       Application.EnableVisualStyles();
       Application.SetCompatibleTextRenderingDefault(false);
       Application.Run(new MainForm());
   }
}

处理特殊情况：

当MainWindowHandle为 null 时（如控制台程序或后台服务），需改用其他激活方式
可添加日志记录：if (existingProcess != null) Log.WriteLine("发现已有实例");
支持命令行参数传递：可将新启动的参数传递给已有实例处理

三、注意事项与优化点

1. 窗口激活限制

Windows 系统对窗口激活有安全限制，某些情况下可能无法成功设置前台窗口
解决方案：可添加窗口闪烁提示或任务栏图标高亮（需扩展 API 调用）

2. 进程名称问题

Process.ProcessName默认获取程序主模块名称（不含扩展名）
若存在同名但不同路径的程序，可能导致误判
优化方案：可增加路径检查p.MainModule.FileName == currentProcess.MainModule.FileName

3. 权限与兼容性

需要 Windows 平台支持（依赖 User32.dll）
以管理员身份运行时需注意权限匹配问题
控制台程序使用时需处理无主窗口的情况（跳过窗口激活步骤）

4. 扩展功能建议

// 可选增强功能示例
public static class ProcessSingleton
{
   // 添加带参数传递的激活方法
   public static void DisplayInstance(Process instance, string\[] arguments)
   {
       // 可通过剪贴板、命名管道等方式传递参数
       // 或通过窗口消息发送自定义指令
   }

   // 检查实例时添加进程存活验证
   public static Process GetValidInstance()
   {
       var instance = GetInstance();
       return instance != null && !instance.HasExited ? instance : null;
   }
}

四、完整代码与依赖

所需命名空间：

using System;
using System.Diagnostics;
using System.Runtime.Interopservices;

完整工具类：

[请直接复制文章开头的 ProcessSingleton 类代码]

使用示例项目结构：

YourProject
├─ Program.cs          // 程序入口（修改启动逻辑）
├─ ProcessSingleton.cs // 单实例工具类
└─ MainForm.cs         // 主窗口（WinForms/WPF）

五、总结

通过ProcessSingleton工具类，我们实现了：

1. 高效的进程实例检查机制
1. 可靠的窗口激活功能
1. 灵活的 Windows API 封装

这种实现方式具有以下优点：

1. 跨版本兼容性（支持.NET Framework/Core/5+）
1. 轻量级实现（无需第三方库）
1. 可扩展性（方便添加参数传递、日志记录等功能）

在实际项目中使用时，建议根据具体场景添加：

1. 异常处理（防止进程意外终止导致的残留实例）
1. 实例通信机制（如通过管道传递启动参数）
1. UI 线程安全检查（在 WPF 中需使用 Dispatcher.Invoke）

通过合理运用单实例技术，我们可以有效提升应用程序的稳定性和用户体验，避免重复实例导致的资源浪费和状态混乱问题。如果你在使用过程中遇到特殊场景或需要进一步优化，欢迎在评论区分享你的经验！