在Avalonia中实现单例运行需用Mutex跨进程互斥：Main中创建唯一命名Mutex，获取失败则激活已有实例（Windows调用SetForegroundWindow），成功则启动应用；退出时应显式Dispose Mutex。

在 Avalonia 中实现程序单例运行（防止多开），核心思路是：在启动主窗口前检查是否已有实例在运行，若有则激活旧实例并退出新进程。由于 Avalonia 本身不内置单例机制，需借助操作系统级的互斥锁（Mutex）或进程名检测来实现。

使用 Mutex 实现跨进程单例（推荐）

这是最可靠、跨平台兼容性最好的方式（Avalonia 支持 Windows/macOS/Linux，Mutex 在 .NET 6+ 中已跨平台支持）。

• 在 Program.cs 的 Main 方法中，创建一个全局唯一命名的 Mutex
• 若获取失败（即已有实例持有该 Mutex），则通过 IPC 或系统 API 激活已有窗口（Windows 可用 FindWindow + ShowWindow；macOS/Linux 可发信号或依赖 D-Bus，但通常先聚焦已有进程即可）
• 注意：需在应用退出时释放 Mutex（通常由 GC 自动处理，但显式调用 mutex.Dispose() 更稳妥）

示例代码（Program.cs）：

using System;
using System.Diagnostics;
using System.Threading;
using Avalonia;
using Avalonia.Controls.ApplicationLifetimes;
using Avalonia.Markup.Xaml;

class Program
{
    [STAThread]
    public static void Main(string[] args)
    {
        const string mutexName = "MyAvaloniaApp_SingleInstance";
        using var mutex = new Mutex(false, mutexName);

        if (!mutex.WaitOne(0))
        {
            // 已有实例运行：尝试激活主窗口（仅 Windows 简单有效）
            ActivateExistingInstance();
            return;
        }

        BuildAvaloniaApp()
            .StartWithClassicDesktopLifetime(args);
    }

    private static void ActivateExistingInstance()
    {
        // Windows 下通过进程名找并激活窗口（简单实用）
        var currentProcess = Process.GetCurrentProcess();
        foreach (var p in Process.GetProcessesByName(currentProcess.ProcessName))
        {
            if (p.Id != currentProcess.Id && !p.MainWindowHandle.Equals(IntPtr.Zero))
            {
                // 调用 Win32 API 激活窗口（需引入 user32.dll）
                NativeMethods.SetForegroundWindow(p.MainWindowHandle);
                break;
            }
        }
    }
}

补充 NativeMethods.cs（仅 Windows）：

using System.Runtime.InteropServices;

internal static class NativeMethods
{
    [DllImport("user32.dll")]
    [return: MarshalAs(UnmanagedType.Bool)]
    internal static extern bool SetForegroundWindow(IntPtr hWnd);
}

使用 Avalonia 内部生命周期配合 IPC（进阶）

若需传递命令行参数给已有实例（如打开指定文件），可结合命名管道（NamedPipeServerStream / NamedPipeClientStream）或内存映射文件实现轻量 IPC。

• 首次启动时，启动一个后台监听的命名管道服务
• Avalonia 主窗口监听管道消息，动态响应（如 OpenFile(path)）

注意事项与避坑点

避免以下常见问题：

• Mutex 名称需全局唯一：建议用反向域名格式，如 "com.mycompany.myapp.2025"，避免与其他软件冲突
• 不要仅靠进程名判断：多个不同应用可能同名，必须配合 Mutex 或窗口句柄校验
• macOS/Linux 激活限制：无等效 SetForegroundWindow，可调用 Process.Start("open", "-a MyApp") 或依赖桌面环境协议（如 xdg-activate，需额外工具）
• 调试时注意：VS 调试会反复启停，Mutex 可能残留；开发阶段可加条件编译（如 #if DEBUG 跳过单例）

基本上就这些。Mutex 方案简单稳定，覆盖所有 Avalonia 支持平台，是首选方案。需要传参再加一层 IPC 即可，不复杂但容易忽略细节。