如何用Java Swing实现可穿透点击的JFrame（仿Swift ignoresMouseEvents）

架构老林

2026-5-21

嘿，刚好折腾过类似的需求！要在Java Swing里实现像Swift的ignoresMouseEvents那样的点击穿透窗口——就是那种半透明统计覆盖层，不挡着下面程序和游戏操作的效果——得针对不同操作系统搞原生调用，毕竟Swing本身没给跨平台的直接API。下面把Java跨平台实现和Swift的对应方案都给你理清楚：

在Java Swing中实现跨平台点击穿透窗口

核心思路

点击穿透的本质是让操作系统把窗口的鼠标事件直接传递给下层窗口，Swing本身不提供这个能力，所以得调用各平台的原生API来实现。

分平台实现代码

1. Windows平台

Windows下需要调用SetWindowLongPtr和SetLayeredWindowAttributes来设置窗口属性，把窗口设为透明且点击穿透：

import com.sun.jna.Native;
import com.sun.jna.platform.win32.User32;
import com.sun.jna.platform.win32.WinDef;
import com.sun.jna.platform.win32.WinUser;

import javax.swing.*;
import java.awt.*;

public class ClickThroughWindow extends JFrame {
    public ClickThroughWindow() {
        setUndecorated(true);
        setAlwaysOnTop(true);
        setBackground(new Color(0, 0, 0, 0)); // 全透明背景，后续可以通过组件设置半透明内容
        setSize(800, 600);
        setLocationRelativeTo(null);

        // 添加统计信息组件
        JLabel statsLabel = new JLabel("<html><h1 style='color:white;'>CPU: 25% | RAM: 4GB</h1></html>");
        statsLabel.setOpaque(false);
        add(statsLabel);

        setVisible(true);

        // Windows平台设置点击穿透
        WinDef.HWND hwnd = new WinDef.HWND(Native.getWindowPointer(this));
        User32 user32 = User32.INSTANCE;
        long exStyle = user32.GetWindowLongPtr(hwnd, WinUser.GWL_EXSTYLE).longValue();
        // 添加上层窗口+透明属性
        exStyle |= WinUser.WS_EX_LAYERED | WinUser.WS_EX_TRANSPARENT;
        user32.SetWindowLongPtr(hwnd, WinUser.GWL_EXSTYLE, new WinDef.LONG_PTR(exStyle));
        // 设置窗口透明度（这里设为完全不透明，因为我们靠组件内容显式半透明）
        user32.SetLayeredWindowAttributes(hwnd, 0, (byte) 255, WinUser.LWA_ALPHA);
    }

    public static void main(String[] args) {
        SwingUtilities.invokeLater(ClickThroughWindow::new);
    }
}

注意：这里用到了JNA库来调用Windows原生API，需要在项目中引入依赖，比如Maven的net.java.dev.jna:jna-platform:5.13.0

2. macOS平台

macOS下可以通过反射调用Apple的AWT扩展，直接设置窗口的ignoresMouseEvents属性，和Swift的逻辑几乎一致：

import javax.swing.*;
import java.awt.*;
import java.lang.reflect.Method;

public class MacClickThroughWindow extends JFrame {
    public MacClickThroughWindow() {
        setUndecorated(true);
        setAlwaysOnTop(true);
        setBackground(new Color(0, 0, 0, 0));
        setSize(800, 600);
        setLocationRelativeTo(null);

        JLabel statsLabel = new JLabel("<html><h1 style='color:white;'>CPU: 25% | RAM: 4GB</h1></html>");
        statsLabel.setOpaque(false);
        add(statsLabel);

        setVisible(true);

        // macOS平台设置点击穿透
        try {
            // 反射获取NSWindow实例并设置忽略鼠标事件
            Class<?> nsWindowHelper = Class.forName("com.apple.eawt.Window");
            Method getNSWindowMethod = nsWindowHelper.getMethod("getNSWindow", Window.class);
            Object nsWindow = getNSWindowMethod.invoke(null, this);
            Method setIgnoresMouseEvents = nsWindow.getClass().getMethod("setIgnoresMouseEvents", boolean.class);
            setIgnoresMouseEvents.invoke(nsWindow, true);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    public static void main(String[] args) {
        SwingUtilities.invokeLater(MacClickThroughWindow::new);
    }
}

注意：这个方法只在Oracle JDK或Apple提供的JDK上有效，OpenJDK可能需要额外配置Apple AWT扩展。

3. Linux平台

Linux下依赖窗口管理器（比如GNOME、KDE）支持，需要设置窗口的_NET_WM_INPUT_INHIBITING属性来实现输入透明：

import javax.swing.*;
import java.awt.*;
import com.sun.jna.Native;
import com.sun.jna.platform.unix.X11;

public class LinuxClickThroughWindow extends JFrame {
    public LinuxClickThroughWindow() {
        setUndecorated(true);
        setAlwaysOnTop(true);
        setBackground(new Color(0, 0, 0, 0));
        setSize(800, 600);
        setLocationRelativeTo(null);

        JLabel statsLabel = new JLabel("<html><h1 style='color:white;'>CPU: 25% | RAM: 4GB</h1></html>");
        statsLabel.setOpaque(false);
        add(statsLabel);

        setVisible(true);

        // Linux平台设置点击穿透
        try {
            X11 x11 = X11.INSTANCE;
            X11.Display display = x11.XOpenDisplay(null);
            long windowPtr = Native.getWindowPointer(this);

            // 设置窗口半透明（可选）
            X11.Atom opacityAtom = x11.XInternAtom(display, "_NET_WM_WINDOW_OPACITY", false);
            float opacity = 0.8f;
            long opacityValue = (long) (opacity * 0xFFFFFFFFL);
            x11.XChangeProperty(display, windowPtr, opacityAtom, X11.XA_CARDINAL, 32,
                    X11.PropModeReplace, new byte[]{(byte)(opacityValue >> 24), (byte)(opacityValue >> 16), (byte)(opacityValue >> 8), (byte)opacityValue}, 1);

            // 设置输入透明
            X11.Atom inputInhibitAtom = x11.XInternAtom(display, "_NET_WM_INPUT_INHIBITING", false);
            x11.XChangeProperty(display, windowPtr, inputInhibitAtom, X11.XA_ATOM, 32,
                    X11.PropModeReplace, new byte[0], 0);

            x11.XCloseDisplay(display);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    public static void main(String[] args) {
        SwingUtilities.invokeLater(LinuxClickThroughWindow::new);
    }
}

注意：Linux下的实现依赖窗口管理器的支持，不同桌面环境可能需要调整属性。

跨平台整合建议

可以通过判断操作系统类型，动态选择对应的实现：

public class CrossPlatformClickThroughWindow extends JFrame {
    public CrossPlatformClickThroughWindow() {
        setUndecorated(true);
        setAlwaysOnTop(true);
        setBackground(new Color(0, 0, 0, 0));
        setSize(800, 600);
        setLocationRelativeTo(null);

        JLabel statsLabel = new JLabel("<html><h1 style='color:white;'>CPU: 25% | RAM: 4GB</h1></html>");
        statsLabel.setOpaque(false);
        add(statsLabel);

        setVisible(true);

        String os = System.getProperty("os.name").toLowerCase();
        if (os.contains("win")) {
            setupWindowsClickThrough();
        } else if (os.contains("mac")) {
            setupMacClickThrough();
        } else if (os.contains("nix") || os.contains("nux")) {
            setupLinuxClickThrough();
        }
    }

    // 这里分别实现上面三个平台的setup方法即可...

    public static void main(String[] args) {
        SwingUtilities.invokeLater(CrossPlatformClickThroughWindow::new);
    }
}

Swift 实现顶层覆盖窗+ignoresMouseEvents

既然你提到了Swift的相关需求，这里也补充一下Swift中如何实现类似Helium的顶层半透明覆盖窗，这个就简洁多了：

import Cocoa

class OverlayWindow: NSWindow {
    override init(contentRect: NSRect, styleMask style: NSWindow.StyleMask, backing backingStoreType: NSWindow.BackingStoreType, defer flag: Bool) {
        super.init(contentRect: contentRect, styleMask: .borderless, backing: .buffered, defer: flag)
        self.level = .screenSaver // 设为最高层级，确保在所有窗口之上
        self.isOpaque = false
        self.backgroundColor = NSColor.clear
        self.ignoresMouseEvents = true // 关键：忽略鼠标事件，直接穿透到下层窗口
        // 支持多空间和全屏模式
        self.collectionBehavior = [.canJoinAllSpaces, .fullScreenAuxiliary]
    }
}

class OverlayViewController: NSViewController {
    override func loadView() {
        self.view = NSView(frame: NSScreen.main!.frame)
        self.view.wantsLayer = true
        // 设置半透明背景
        self.view.layer?.backgroundColor = NSColor(red: 0, green: 0, blue: 0, alpha: 0.2).cgColor

        // 添加统计标签
        let statsLabel = NSTextField(labelWithString: "CPU: 25% | RAM: 4GB")
        statsLabel.textColor = .white
        statsLabel.font = NSFont.systemFont(ofSize: 24, weight: .bold)
        statsLabel.frame = NSRect(x: 50, y: 50, width: 400, height: 50)
        self.view.addSubview(statsLabel)
    }
}

// 启动应用
let app = NSApplication.shared
let screenFrame = NSScreen.main!.frame
let window = OverlayWindow(contentRect: screenFrame, styleMask: .borderless, backing: .buffered, defer: false)
let viewController = OverlayViewController()
window.contentViewController = viewController
window.makeKeyAndOrderFront(nil)
app.run()

这个实现直接利用了NSWindow的ignoresMouseEvents属性，天然支持macOS的多空间和全屏模式，和Helium的效果完全一致。

内容的提问来源于stack exchange，提问作者Enrique Wood