C# WinForm 单实例运行与窗口激活方案

Elena

发布时间：2026-10-13| 5人浏览过

原创

在 C# WinForm 开发中，强制程序只允许运行一个实例不仅能避免资源冲突，还能在用户重复双击图标时自动聚焦已打开的窗口。通过结合 System.Diagnostics.Process 进行路径一致性校验，以及调用 User32.dll API 实现窗体激活，即可高效解决此需求。

问题背景与目标

在桌面应用开发中，如果允许用户同时打开多个相同程序的实例，可能会导致数据读写冲突、内存占用过高或界面逻辑混乱。我们的目标是：

检测当前进程中是否已存在同名的应用程序实例。
确保进程来自同一文件路径，防止误判。
若实例已存在，不再启动新窗口，而是将旧窗口激活并置于前台。

准备条件

本方案基于标准 C# .NET Framework 或 .NET Core/5+ WinForm 项目。主要依赖以下命名空间：

System.Diagnostics：用于进程操作。
System.Reflection：用于获取程序集信息。
System.Runtime.InteropServices：用于调用 Windows 原生 API。
System.Windows.Forms：WinForm 基础类库。

具体操作顺序

第1步：修改入口点代码结构

在项目的 Program.cs 文件中，找到 Main 方法。我们需要在此处植入实例检查逻辑，取代原有的直接 Application.Run 调用。

[STAThread]
static void Main()
{
    Application.EnableVisualStyles();
    Application.SetCompatibleTextRenderingDefault(false);

    // 检查是否已有实例在运行
    Process instance = RunningInstance();
    if (instance == null)
    {
        // 没有实例，启动新主窗体
        Application.Run(new frmMain());
    }
    else
    {
        // 已有实例，激活旧窗口
        HandleRunningInstance(instance);
    }
}

第2步：实现进程检测逻辑 (RunningInstance)

创建一个私有静态方法来遍历当前系统进程，筛选出与当前程序同名且来自同一文件的进程。关键步骤在于排除自身进程 ID 并进行路径比对，以防止同一进程被错误识别为另一个实例。

private static Process RunningInstance()
{
    Process current = Process.GetCurrentProcess();
    Process[] processes = Process.GetProcessesByName(current.ProcessName);

    foreach (Process process in processes)
    {
        // 忽略当前运行的进程本身
        if (process.Id != current.Id)
        {
            try
            {
                // 核心判断：比较可执行文件路径
                // 注意处理路径分隔符差异（Windows下通常为反斜杠）
                string currentPath = Assembly.GetExecutingAssembly().Location.Replace("/", "\\") ;
                string targetPath = process.MainModule.FileName;

                if (currentPath == targetPath)
                {
                    return process; // 找到匹配的实例
                }
            }
            catch (Exception)
            {
                // 某些系统进程可能无法访问模块信息，直接跳过
                continue;
            }
        }
    }
    return null;
}

注意：在较新的 .NET 版本中，process.MainModule 可能在某些权限不足的情况下抛出异常，建议包裹在 try-catch 中以确保健壮性。

第3步：实现窗口激活逻辑 (HandleRunningInstance)

当检测到已存在的进程后，需要将该进程的窗口焦点转移到前台。这需要引入 Win32 API 函数 ShowWindowAsync 和 SetForegroundWindow。

private static void HandleRunningInstance(Process instance)
{
    try
    {
        // 确保窗口处于可见状态
        ShowWindowAsync(instance.MainWindowHandle, 1);
        // 将窗口设置为前台活跃窗口
        SetForegroundWindow(instance.MainWindowHandle);
    }
    catch
    {
        // 若主窗口未完全加载或句柄无效，静默失败或记录日志
    }
}

// 声明 Win32 API
[DllImport("User32.dll")]
private static extern bool ShowWindowAsync(System.IntPtr hWnd, int cmdShow);

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