在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.2024"，避免与其他软件冲突 - 不要仅靠进程名判断：多个不同应用可能同名，必须配合 Mutex 或窗口句柄校验
-
macOS/Linux 激活限制：无等效
SetForegroundWindow，可调用Process.Start("open", "-a MyApp")或依赖桌面环境协议（如xdg-activate，需额外工具） -
调试时注意：VS 调试会反复启停，Mutex 可能残留；开发阶段可加条件编译（如
#if DEBUG跳过单例）
基本上就这些。Mutex 方案简单稳定，覆盖所有 Avalonia 支持平台，是首选方案。需要传参再加一层 IPC 即可，不复杂但容易忽略细节。
