简介利用Java Swing实现的桌面宠物小项目面向刚接触GUI编程或对动画交互感兴趣的Java开发者可帮助理解桌面应用从窗口构建到用户交互的完整流程。压缩包共80个文件主要包含Java源码、编译后的class字节码、13张宠物表情jpg图片以及Eclipse工程配置整体仅122KB轻巧便于快速下载和对照学习。目前已有2643人学习项目难度适中适合在校学生或自学者作为练手参考。代码中重点示范了JFrame/JPanel窗口搭建、自定义组件重写paintComponent绘图、Graphics2D绘制、鼠标拖拽事件监听以及javax.swing.Timer定时器驱动的动画循环并涉及多线程协作处理交互与刷新能让读者直观理解宠物走动、表情切换这类动态效果的后台实现机制。无论是补充Java GUI实践还是寻找课程设计的小灵感这份小例子都值得动手运行体会。1. 桌面宠物不是玩具一个 Java 小例子背后的窗口技术门槛很多人第一次看到 Java 写的桌面宠物第一反应是「这不就是个小动画挂屏幕上嘛」。真做一遍才知道最难的从来不是画一只猫或者让它眨眼睛而是让那个窗口透明、置顶、不抢焦点、不占任务栏还能被鼠标拖着满屏跑。哪怕是一个只有几百行代码的桌面宠物小例子背后也踩遍了 JFrame 透明化、无边框窗口、鼠标偏移、多屏坐标这些坑。这篇文章要讲的就是用纯 JavaSwing/AWT写一个桌面宠物小例子的完整落地路径。它不会给你一只精美的动画角色但会给出一套能跑、能改、能扩展的骨架透明窗口怎么开、动画帧怎么切、鼠标拖动为什么总跳、任务栏图标怎么藏、多显示器下坐标为什么乱了。适合刚学完 Java SE、想拿 GUI 练手的人也适合那些被「透明窗口黑底」「拖动闪烁」「切到全屏游戏宠物消失」折磨过的半路出家开发者。我会把代码逻辑、关键参数和踩过的坑混在一起讲不绕弯子。读完你不仅能复现一个能用的桌面宠物还能顺手理解 Java 窗口编程里那些平时没人跟你讲清楚的边界条件。2. 先把原理立住Java 里做个「无边框 透明 置顶」的悬浮窗为什么绕不开 Swing2.1 为什么不是 JavaFX也不是 AWT 硬怼写桌面宠物第一步是选 GUI 框架。常见选项就三个AWT、Swing、JavaFX。AWT 组件是重量级的依赖本地对等组件透明度和逐像素alpha控制基本没法做直接排除。JavaFX 能做很炫的动画和透明效果但它要额外运行时模块打包分发时体积和兼容性都是成本。Swing 是最稳妥的选择JDK 自带、轻量组件体系、支持半透明窗口配合 AWT 的事件模型和 Robot 类桌面宠物的需求基本全覆盖。实际项目里我一般这么选纯自娱自乐、快速出效果用 Swing要做成产品级比如带设置面板、多皮肤、自动更新再考虑 JavaFX 或者把 UI 层抽出来换 Electron。桌面宠物本质上是个常驻内存的轻量级进程Swing 的启动速度和内存占用都更友好。2.2 透明窗口的三个关键类JFrame、JWindow 与 AWTUtilitiesSwing 里做透明悬浮窗核心是 JWindow 或者 JFrame 加无边框设置。JWindow 没有标题栏也没有边框天生适合做悬浮物但它没有焦点管理处理输入事件时有些限制。JFrame 更灵活能设置顶、能控制任务栏显示代价是要自己去掉装饰。关键点在「真正透明」这件事上。传统做法是给 JPanel 覆写paintComponent把背景色设成透明但窗口本身还是矩形的露出来的部分会是一块黑底或者白底。要让窗口本身透明JDK 6u10 之后引入了com.sun.awt.AWTUtilities提供了setWindowOpacity和setWindowShape。前者让整个窗口半透明后者能裁剪窗口形状。// 让窗口整体半透明 com.sun.awt.AWTUtilities.setWindowOpacity(window, 0.8f); // 把窗口裁剪成自定义形状比如圆形 java.awt.Shape shape new java.awt.geom.Ellipse2D.Float(0, 0, 200, 200); com.sun.awt.AWTUtilities.setWindowShape(window, shape);这段代码的逻辑是先拿到窗口对象再对窗口整体施加透明度或形状裁剪。注意setWindowOpacity是整体透明度不是单个像素的 alpha 通道所以它做不了「窗口里一块透明一块不透明」的效果。要逐像素透明得靠setWindowShape裁剪出形状或者用后来的setBackground(new Color(0, 0, 0, 0))配合透明面板。参数说明0.8f是透明度系数1.0f 完全不透明0.0f 完全消失。Ellipse2D.Float的四个参数依次是 x、y、宽、高单位是像素。裁剪形状可以在运行时动态更换这是做「点击宠物切换形态」这类交互的基础。不过 AWTUtilities 是内部 API不同 JDK 版本里包名和类名可能有变动。更稳妥的做法是用GraphicsDevice的透明支持能力查询或者直接上 JNA/JNI 调操作系统 API。但作为学习例子AWTUtilities 够用了跑在 JDK 8 上没有任何问题。2.3 窗口置顶与穿透点击桌面宠物「不碍事」的两个开关桌面宠物必须置顶显示否则开个浏览器就把它盖住了。Swing 里置顶是 JFrame 的方法setAlwaysOnTop(true)但有个坑多个置顶窗口互相抢层级而且全屏应用程序比如游戏可能不受这个控制。另一个更有意思的是「鼠标穿透」。做桌面宠物时经常希望它不挡鼠标——点它身体时能交互点它空白区域时鼠标直接穿透到桌面图标上。Swing 里实现穿透不直接需要调原生方法。常见做法是用 JNA 调用 Windows 的WS_EX_TRANSPARENT扩展样式或者用 AWT 的MouseAdapter手动判断点击区域panel.addMouseListener(new MouseAdapter() { Override public void mouseClicked(MouseEvent e) { // 仅当点击落在宠物实际像素范围内时才响应 if (petBitmap.getRGB(e.getX(), e.getY()) ! 0) { doAction(); } } });这段代码的关键是getRGB判断像素是否透明。0 表示完全透明非 0 表示有内容。这样哪怕窗口是矩形用户点透明边角时也不会触发交互。实际项目中判断区域可能用多边形或像素遍历但原理一样。2.4 为什么还要关心 EDT动画卡顿和点击无响应的根源Java GUI 程序里所有界面操作必须在事件分发线程EDT上执行。桌面宠物要持续播放动画如果动画循环直接写在主线程里会导致窗口无响应、拖动卡顿、CPU 飙高。// 错误示范在主线程里死循环刷帧 while (running) { panel.repaint(); Thread.sleep(100); } // 正确做法用 Swing Timer 驱动动画 javax.swing.Timer timer new javax.swing.Timer(100, e - { currentFrame (currentFrame 1) % frameCount; panel.repaint(); }); timer.start();Swing Timer 的回调自动在 EDT 上执行不会阻塞事件队列。参数100是毫秒表示每 100 毫秒切换一帧对应 10 FPS。桌面宠物的动画不需要 60 FPS10~15 FPS 就够流畅了还能省 CPU。常见误用是把Thread.sleep和repaint混在一起然后发现窗口拖动时出现残影和撕裂。其实 repaint 只是打个标记真正重绘由 EDT 统一调度你手动 sleep 只是把事件队列堵住了。3. 搭出能跑的最小骨架透明窗口 鼠标拖动 右键菜单3.1 先准备素材一张带透明通道的 PNG 和它的裁切坐标写代码前先说素材。桌面宠物本质上就是一张会动的图片所以图片质量决定了最终效果的一半以上。要求很简单PNG 格式、带 alpha 通道、主体居中。不要用 JPGJPG 没有透明通道透明窗口直接废了。常见素材来源是拆游戏立绘、自己画、或者拿现成的 gif 逐帧导出。不管哪种建议把每帧裁成相同尺寸统一放在 resources 目录下。命名规则建议用前缀加序号比如cat_001.png、cat_002.png方便代码里按规律加载。真没有美术资源时一个粗糙但能跑的方案是用程序生成比如画一个圆形色块代表宠物身体用渐变模拟体积。代码会显得很「程序员美术」但至少流程是通的——你要验证的是窗口和动画机制不是画技。3.2 最小窗口代码无边框、透明、置顶、不抢焦点下面这段是我平时起项目的模板大概七八十行跑起来就能看到一只悬浮在桌面上的小东西。import javax.swing.*; import java.awt.*; import java.awt.event.*; import java.awt.image.BufferedImage; import javax.imageio.ImageIO; import java.io.File; public class DesktopPet { private JWindow window; private JLabel petLabel; private BufferedImage currentImage; private Point dragOffset; public DesktopPet() { window new JWindow(); window.setAlwaysOnTop(true); window.setSize(150, 150); // 核心透明背景 window.setBackground(new Color(0, 0, 0, 0)); petLabel new JLabel(); petLabel.setOpaque(false); window.add(petLabel); // 加载图片 try { currentImage ImageIO.read(new File(pet.png)); petLabel.setIcon(new ImageIcon(currentImage)); } catch (Exception e) { e.printStackTrace(); } // 拖动逻辑 addDragListener(petLabel); // 右键退出菜单 addContextMenu(petLabel); window.setVisible(true); } private void addDragListener(JComponent comp) { comp.addMouseListener(new MouseAdapter() { Override public void mousePressed(MouseEvent e) { dragOffset e.getPoint(); } }); comp.addMouseMotionListener(new MouseMotionAdapter() { Override public void mouseDragged(MouseEvent e) { Point current e.getLocationOnScreen(); window.setLocation(current.x - dragOffset.x, current.y - dragOffset.y); } }); } private void addContextMenu(JComponent comp) { JPopupMenu menu new JPopupMenu(); JMenuItem exitItem new JMenuItem(退出); exitItem.addActionListener(e - System.exit(0)); menu.add(exitItem); comp.setComponentPopupMenu(menu); } public static void main(String[] args) { SwingUtilities.invokeLater(DesktopPet::new); } }逻辑拆开说JWindow本身就是无边框的setAlwaysOnTop(true)保证置顶setBackground(new Color(0,0,0,0))是透明关键——这里的 alpha 是 0整个窗口背景完全透明。JLabel放图片setOpaque(false)让 JLabel 自己也别画不透明背景。拖动逻辑里dragOffset是按下瞬间鼠标在组件内的相对坐标e.getLocationOnScreen()拿到鼠标的屏幕坐标两者相减得到窗口新位置。参数说明窗口大小 150x150 是初始值实际应该根据图片实际尺寸调整否则图片和窗口大小不一致时会出现内容偏移或拉伸。dragOffset必须在mousePressed里记录不能在mouseDragged里用e.getPoint()——那个值是相对组件左上角的不是屏幕坐标。JPopupMenu 挂到 JLabel 上点击组件时弹出右键菜单。setComponentPopupMenu是 Swing 封装好的方法内部已经处理了左右键区分不需要手动判断。启动时SwingUtilities.invokeLater保证构建窗口的代码跑在 EDT 上这是 Java GUI 的基本修养。3.3 拖动为什么会「跳一下」鼠标偏移问题彻底说清标题里说的「跳一下」是个高频翻车现场。表现是按下宠物准备拖鼠标瞬间跳到宠物的左上角宠物像被「吸」过去一样。原因就一句话——window.setLocation用了鼠标的屏幕坐标但没减去鼠标在窗口内的相对偏移。很多第一次写的人mouseDragged里直接写window.setLocation(e.getLocationOnScreen())结果鼠标变成了窗口的左上角。上面代码里dragOffset就是为了解决这个的。还有个隐形坑mousePressed里e.getPoint()返回的是相对组件的坐标你如果拿它和getLocationOnScreen()运算坐标系不统一数字会错乱。// 正确写法 Point current e.getLocationOnScreen(); // 鼠标屏幕坐标 window.setLocation(current.x - dragOffset.x, current.y - dragOffset.y);dragOffset.x是鼠标在宠物图片内的横向偏移dragOffset.y是纵向偏移。用屏幕坐标减偏移执行完后鼠标仍然停留在宠物身上的同一个相对位置。如果发现拖动时宠物「飘」多半是 offset 没更新如果发现拖动时宠物「瞬移」多半是坐标系混了。3.4 多显示器下的坐标迷局负坐标、缩放和 DPI 的连锁反应Windows 上接双显示器时副屏可能在主屏左边或上方坐标会出现负值。getLocationOnScreen返回的坐标在虚拟屏幕空间里是连续的但不同显示器可能有不同 DPI 缩放。常见的坑是副屏 DPI 是 125%主屏是 100%宠物从主屏拖到副屏时鼠标坐标和窗口坐标突然对不上或者窗口大小看起来变大了。Swing 的事件坐标在非统一 DPI 环境下可能不准确。最直接的办法是禁用 DPI 缩放在main方法里加系统属性System.setProperty(sun.java2d.uiScale, 1.0); System.setProperty(sun.java2d.dpiaware, true);sun.java2d.uiScale设为 1.0 表示禁用缩放窗口在所有显示器上保持像素一致。dpiaware设为 true 表示支持高 DPI这两个一起用能让多屏场景更可控。代价是高分屏上字体会偏小但桌面宠物主要以图形为主影响不大。如果你需要真正的多屏坐标处理应该用GraphicsEnvironment.getScreenDevices()遍历所有显示器计算窗口相对每个显示器的位置而不是只依赖全局坐标。这对桌面宠物来说有点过度设计但做多显示器适配时必须知道有这么回事。4. 让它活起来动画帧切换的三种方案和性能取舍4.1 帧动画循环从 Timer 到精确帧率控制静态图能看但桌面宠物的魅力在于动态。最简单的方式是准备一组图片按顺序循环显示就是帧动画。上面提到用 Swing Timer 驱动但这只是最粗的方式。实际做的时候要考虑帧率稳定性和资源占用。Timer timer new Timer(66, e - { currentFrame (currentFrame 1) % totalFrames; petLabel.setIcon(new ImageIcon(frameImages[currentFrame])); });66毫秒大约 15 帧每秒动画看起来是流畅的。帧率调高到 30 FPS 以上肉眼几乎无法分辨提升但 CPU 占用会上升好几倍。桌面宠物是后台程序没必要追求高帧率。经验值闲置动画 10~15 FPS交互动作比如被点击时可以临时提到 20 FPS持续一两秒再降回来。更省资源的方式是只重绘变化区域。Swing 的repaint(Rectangle)可以指定重绘范围但桌面宠物动画通常每帧都是整张图变化优化空间不大。真正有效的是减少图片解码次数——把图片一次性加载到 BufferedImage 数组动画循环里只做 setIcon 或 paintImage不要每次重新ImageIO.read。4.2 弹簧物理与随机游走不用写复杂算法也有「活」的感觉静态动画循环看久了还是会腻宠物应该有点「性格」。常见做法是给宠物加简单的随机位移和小动作不需要复杂的 AI一点点随机性就够。// 宠物每隔几秒随机移动一小段距离 Timer moveTimer new Timer(2000, e - { if (Math.random() 0.3) { int dx (int)(Math.random() * 40 - 20); int dy (int)(Math.random() * 20 - 10); Point p window.getLocation(); window.setLocation(p.x dx, p.y dy); } });随机移动的幅度控制在 ±20 像素以内看起来像是在「东张西望」而不是「乱跑」。更活泼的做法是让宠物跟随鼠标——在屏幕边缘设置感应区鼠标靠近时宠物朝反方向移动做出「怕鼠标」的样子。这需要用到MouseInfo.getPointerInfo().getLocation()获取鼠标位置配合 Swing Timer 定期采样不需要监听全屏事件。Timer followTimer new Timer(50, e - { Point mouse MouseInfo.getPointerInfo().getLocation(); Point pet window.getLocation(); int dx mouse.x - pet.x; int dy mouse.y - pet.y; double dist Math.hypot(dx, dy); if (dist 0 dist 100) { int moveX (int)(dx / dist * 5); // 移开 int moveY (int)(dy / dist * 5); window.setLocation(pet.x - moveX, pet.y - moveY); } });dist是鼠标与宠物的欧氏距离dx / dist得到单位方向向量乘以 5 是每帧移动速度按像素计算。小于 100 像素时宠物开始闪避移开方向是鼠标的反方向。这段代码用到了Math.hypot计算距离避免中间结果溢出这在动画循环里是个很实用的细节。4.3 动画性能的三个必调参数帧率、图片缓存、重绘范围性能问题是桌面宠物被诟病的重灾区。一个没优化好的宠物能把 CPU 吃到 20% 以上堪比一个视频播放器。三个最关键的参数帧率闲置 10~15 FPS交互瞬间 20 FPS。用 Timer 的 delay 控制不建议低于 30ms即 33 FPS 以上因为 Swing 重绘能力有限过高的帧率只会浪费 CPU。图片缓存所有帧预先加载为 BufferedImage存储在数组里。不要在 paint 方法里做图片缩放或格式转换。如果原图太大加载时统一缩放一次BufferedImage original ImageIO.read(file); BufferedImage scaled new BufferedImage(150, 150, BufferedImage.TYPE_INT_ARGB); Graphics2D g2d scaled.createGraphics(); g2d.setRenderingHint(RenderingHints.KEY_INTERPOLATION, RenderingHints.VALUE_INTERPOLATION_BILINEAR); g2d.drawImage(original, 0, 0, 150, 150, null); g2d.dispose();TYPE_INT_ARGB是关键它保证缩放后的图仍有 alpha 通道。VALUE_INTERPOLATION_BILINEAR是双线性插值缩放质量中等偏上性能也能接受。要更好的效果可以换VALUE_INTERPOLATION_BICUBIC但要慢一些。重绘范围如果只是图标切换可以用petLabel.setIcon触发局部重绘如果自己覆写了paintComponent做复合渲染尽量重绘实际脏矩形区域。桌面宠物场景下通常整张小图都要换所以优化空间不大但记住先调用super.paintComponent(g)否则会出现残影。4.4 复合动画多图层叠在一起的渲染方式帧动画呈现的信息量有限有时候想让宠物同时有身体、眼睛、装饰品每个部件独立运动。这时候就不能用简单的 JLabel 换图了需要自定义组件覆写paintComponent。class PetPanel extends JPanel { private BufferedImage body; private BufferedImage eye; private int eyeOffsetX 0; private int eyeOffsetY 0; Override protected void paintComponent(Graphics g) { super.paintComponent(g); Graphics2D g2d (Graphics2D) g; g2d.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON); // 绘制身体 g2d.drawImage(body, 0, 0, null); // 绘制眼睛带偏移模拟视线跟随鼠标 g2d.drawImage(eye, eyeOffsetX, eyeOffsetY, null); } }paintComponent的职责是「每帧绘制的所有内容」。眼睛跟随鼠标的实现方式在 Timer 回调里计算眼睛偏移量然后调用repaint()。KEY_ANTIALIASING是抗锯齿渲染提示画圆、画线条时边缘更平滑但对 drawImage 没有影响加在这是为了后续画矢量元素做准备。多图层渲染时要注意绘制顺序后画的覆盖先画的。body 先画eye 后画眼睛覆盖在身体上面。如果需要透明效果用g2d.setComposite(AlphaComposite.getInstance(AlphaComposite.SRC_OVER, alpha))alpha 取值范围 0.0f~1.0f。5. 必踩的 5 个坑从黑底窗口到任务栏残留排查顺序决定效率5.1 透明窗口是黑底现象设置了setBackground(new Color(0,0,0,0))窗口还是黑底或者灰底。原因最常见的是 JDK 版本太老。AWTUtilities 在 JDK 6u10 之前不存在setBackground透明在 JDK 7 之前也不支持。另一个原因是设置了setUndecorated(false)有装饰的窗口不支持透明。解决检查 JDK 版本至少 JDK 8。确认setUndecorated(true)已经调用。如果用的 JWindow不需要 undecorated但如果换成 JFrame 就必须调用。再不行就把window.setBackground(new Color(0, 0, 0, 0))和setOpacity配合使用先整体调低透明度确认是不是透明机制失效。5.2 拖动时窗口闪烁现象拖动过程中宠物窗口在屏幕上闪烁甚至出现残影。原因拖动事件频率远高于重绘频率EDT 来不及处理。另一个原因是setLocation和repaint在同一个线程里被密集调用触发大量重绘事件但每帧都来不及渲染。解决降低鼠标拖动事件的采样频率或者在mouseDragged里使用window.setLocation后主动调用validate()而不是repaint()。更好的办法是拖动时合并重绘private boolean isDragging false; public void mouseDragged(MouseEvent e) { if (!isDragging) { isDragging true; // 用 SwingUtilities.invokeLater 合并移动事件 SwingUtilities.invokeLater(() - { // 执行移动逻辑 isDragging false; }); } }这属于简单的事件节流把连续触发的事件合并成一次实际动作。复杂场景可以用javax.swing.Timer做 debounce但如果只是桌面宠物的拖动简单标记加 invokeLater 就够。5.3 宠物从任务栏消失了现象运行后宠物窗口正常显示但任务栏上多了一个图标或者反过来——设置置顶后任务栏图标消失程序无法从任务栏恢复。原因JWindow 默认不显示任务栏图标JFrame 默认显示。桌面宠物一般用 JWindow但如果切换成 JFrame默认会占任务栏。还有setType(Type.UTILITY)这个设置会影响任务栏表现。解决如果你用 JWindow 但发现任务栏有图标检查是不是代码里不小心 new 了多个窗口。如果你用 JFrame 且不想要任务栏图标可以设置为工具窗口类型// JFrame 类型改为 UTILITY不显示任务栏图标 frame.setType(Window.Type.UTILITY);这个设置在不同操作系统上表现一致吗并不。Windows 上 UTILITY 类型窗口不占任务栏但会有一个小标题栏即使 undecorated 也可能有残留。Linux 桌面环境对 Type 的支持差异更大。如果目标是全平台一致JWindow 仍然是最稳的选择。5.4 动画播放一段时间后 OOM现象程序运行十几分钟后内存占用持续上升最终报 OutOfMemoryError。原因典型是repaint()过于频繁导致 EDT 积压大量重绘请求或者图片被反复解码旧对象没有及时 GC。另一个隐蔽来源是Robot.createScreenCapture一类的操作截屏产生的图片没有释放。解决先检查 Timer 周期如果低于 30ms调回 66~100ms。然后检查是否每次动画帧都在ImageIO.read如果是改为启动时一次性加载。最后用 JVisualVM 连上去看堆内存里的 byte[] 占了多少能直接看到是不是图片没复用// 启动时预加载所有帧 BufferedImage[] frames new BufferedImage[totalFrames]; for (int i 0; i totalFrames; i) { frames[i] ImageIO.read(new File(frame_ i .png)); } // 循环中只引用 frames[i]不创建新对象5.5 全屏应用或游戏下宠物被盖住现象打开全屏视频或游戏后置顶的宠物消失了退出全屏后它又回来。原因置顶窗口在所有主流系统上都无法覆盖独占全屏的应用程序。Windows 上 DirectX 全屏、macOS 的 Space 切换、Linux 的某些桌面环境全屏窗口都会让普通置顶窗口失效。解决接受这个限制这是操作系统的窗口管理策略决定的。一个变通方案是让宠物自己检测全屏状态——定期截屏看是否有窗口覆盖在宠物位置或者用 JNA 查询前台窗口大小是否等于屏幕分辨率。检测到全屏时自动隐藏宠物Timer checkTimer new Timer(5000, e - { // 通过 Robot 获取前台窗口信息不细展开 if (isFullScreenAppActive()) { window.setVisible(false); } else { window.setVisible(true); } });这个检测频率不能太快每秒一次足够。isFullScreenAppActive的具体实现依赖 JNA 调用用户32.dll 的GetForegroundWindow和GetWindowRect跨平台不可用Windows 上实用。6. 进阶方向系统托盘、开机自启和全局快捷键让桌面宠物真正「活」在系统里桌面宠物做完基本盘后真正让它能长期待在用户桌面上的是系统托盘图标、开机自启和全局快捷键这三个能力。先说系统托盘。Swing 里有现成的SystemTray类可以往托盘区域塞一个图标和菜单。if (SystemTray.isSupported()) { SystemTray tray SystemTray.getSystemTray(); Image trayImage Toolkit.getDefaultToolkit().getImage(tray_icon.png); TrayIcon trayIcon new TrayIcon(trayImage, 桌面宠物, null); PopupMenu trayMenu new PopupMenu(); MenuItem showItem new MenuItem(显示宠物); showItem.addActionListener(e - window.setVisible(true)); MenuItem hideItem new MenuItem(隐藏宠物); hideItem.addActionListener(e - window.setVisible(false)); MenuItem exitItem new MenuItem(退出); exitItem.addActionListener(e - System.exit(0)); trayMenu.add(showItem); trayMenu.add(hideItem); trayMenu.add(exitItem); trayIcon.setPopupMenu(trayMenu); tray.add(trayIcon); }TrayIcon的构造参数依次是图片、工具提示文本、菜单。PopupMenu和 AWT 的 PopupMenu 同名但属于 java.awt这里用的是 AWT 版本所以 MenuItem 也是 AWT 的不能用 Swing 的 JMenuItem。这是容易翻车的地方——两个 PopupMenu 长得像但不是同一个类你 new 错版本了编译都过不去但事件行为会不一致。开机自启Windows 上最简单可靠的方式是写注册表 Run 键。用 JNA 调 Advapi32 的RegSetKeyValue或者直接执行 reg 命令// 仅演示思路实际路径需要转义处理 String cmd reg add \HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Run\ /v PetApp /t REG_SZ /d \\\\ appPath \\\\ /f; Runtime.getRuntime().exec(cmd);Java 里可以用Runtime.exec或ProcessBuilder执行 reg 命令。appPath是当前 jar 文件的绝对路径需要处理路径里的空格——用双引号包住整个路径。删掉自启用reg delete命令。这个方法油腻但极其实用比写一堆 JNA 接口简单得多。注意如果你用的是打包成 exe 的方式分发路径应该指向 exe 而非 java -jar否则开机自启后只打开了命令行宠物没起来。全局快捷键实现方式比较多Swing 的KeyEventDispatcher只能在全应用内生效全局得用 JNativeHook 库。GlobalScreen注册监听器回调里判断按键组合。// JNativeHook 用法不是 JDK 自带 GlobalScreen.registerNativeHook(); GlobalScreen.addNativeKeyListener(new NativeKeyAdapter() { Override public void nativeKeyPressed(NativeKeyEvent e) { if (e.getKeyCode() NativeKeyEvent.VC_H e.isControlPressed()) { window.setVisible(!window.isVisible()); } } });这段是 JNativeHook 的典型用法。离线场景可以封装成一个开关类不让它在非桌面会话下启动——比如无图形界面的 Linux 服务器上注册钩子可能抛异常registerNativeHook需要包在 try-catch 里。这个桌面宠物小例子做到这里基本已经超出「小例子」的范畴了——它有透明窗、帧动画、托盘控制、随机游走、启动自启可以当一个正经的桌面伴侣应用来打磨。回看整个项目最大的教训不是那些 API 记不记得住而是「坐标系和事件线程」这两个基础概念一旦理解到位所有奇怪的 bug 都能顺藤摸瓜找到根因。某次我在 JWindow 和 JFrame 之间切换时拖动偏移突然就不对了排查了一晚上才发现是窗口类型变化导致getInsets不同标题栏占了一截偏移量没剔除掉。这种问题你在文档里搜不到答案只能靠对 Swing 布局机制足够熟才能定位。做桌面宠物代码量不大但涉及的窗口系统知识密度极高当成 Java GUI 的进阶练习非常合适——希望这篇笔记能帮你少走我走过的弯路。本文还有配套的精品资源点击获取