本文介绍如何通过 launch4j maven 插件的 `singleinstance` 配置项，确保打包后的 windows 可执行文件（.exe）在同一系统中仅允许一个实例运行，避免重复启动导致的资源冲突或逻辑异常。
Launch4j 是一款广泛使用的开源工具，可将 Java 应用程序（JAR 包）封装为 Windows 原生 .exe 文件，并提供进程控制、JRE 检测、图标嵌入等增强功能。其中，单实例（Single Instance）支持是其内置的关键特性之一——它并非依赖 Java 层的互斥锁（如 FileLock 或 SharedMemory），而是在 Windows 系统级通过命名互斥体（named mutex）实现：当首个进程启动时创建唯一命名的互斥对象；后续启动尝试会检测该互斥体已存在，从而自动退出新进程（默认行为），并可选地激活已有窗口（需配合 JVM 参数与应用内逻辑）。
在 Maven 项目中，只需在 launch4j-maven-plugin 的
com.github.akman launch4j-maven-plugin 2.13.0 l4j-gui package launch4j gui ${project.build.directory}/${project.artifactId}-${project.version}.jar ${project.build.directory}/myapp.exe com.example.MyApp true
✅ 注意事项：
- singleInstance 仅在 Windows 平台生效（底层调用 Win32 CreateMutexW），Linux/macOS 下会被忽略；
- 启用后，第二次启动时进程将立即终止，不会进入 main() 方法——因此，若需向已有实例传递参数（如打开新文件），必须结合 JVM 启动参数（如 -Dlaunch4j.singleInstance=true）并在 Java 代码中监听 IPC 信号（推荐使用 JUnique 或 JNIWrapper 等第三方库）；
- 若应用含 GUI，建议同时配置
true 防止控制台窗口闪退，并确保主窗口正确响应激活事件； - 测试时请关闭所有相关进程（包括后台残留的 Java 进程），避免互斥体未释放导致误判。
总之，
立即学习“Java免费学习笔记（深入）”；
