Java数字时钟核心是理清线程更新、事件驱动和Swing线程安全；应使用SwingTimer而非手动线程，因其动作监听器自动在EDT执行，避免UI冻结或异常。
Java初学者做数字时钟，核心不是“画界面”或“写逻辑”，而是理清线程更新、事件驱动和 Swing 线程安全这三件事。用 SwingTimer 替代手动启线程，是最稳妥的起点。
为什么不用 Thread.sleep() + 无限循环更新时间
新手常写一个 while(true) 循环，Thread.sleep(1000) 后调用 label.setText() —— 这会导致 UI 冻结或抛出 java.lang.IllegalStateException: must be invoked on Event Dispatch Thread。
原因：Swing 组件不是线程安全的，所有 UI 更新必须在事件分发线程（EDT）中执行。手动线程无法保证这点。
正确做法是使用 javax.swing.Timer：
立即学习“Java免费学习笔记（深入）”；
Timer timer = new Timer(1000, e -> {
LocalDateTime now = LocalDateTime.now();
String timeStr = now.format(DateTimeFormatter.ofPattern("HH:mm:ss"));
timeLabel.setText(timeStr);
});
timer.start();
关键点：
-
Timer的动作监听器自动在 EDT 中执行，无需手动SwingUtilities.invokeLater() - 构造参数
1000是毫秒间隔，不是“每秒精确触发”——它只保证「至少延迟 1 秒后执行」，连续多次延迟可能累积误差 - 如果需要毫秒级精度（比如倒计时），得用
System.nanoTime()校准，但初学者不必过早优化
如何让时钟支持 12 小时制和日期显示切换
功能扩展不靠重写逻辑，而靠复用 DateTimeFormatter 和响应按钮点击事件。
常见错误是把格式字符串硬编码进 setText()，导致切换逻辑散落各处。建议封装一个更新方法：
private DateTimeFormatter timeFormatter = DateTimeFormatter.ofPattern("HH:mm:ss");
private DateTimeFormatter dateTimeFormatter = DateTimeFormatter.ofPattern("MM/dd/yyyy HH:mm:ss");
private void updateTime() {
LocalDateTime now = LocalDateTime.now();
String display = showDate ? dateTimeFormatter.format(now) : timeFormatter.format(now);
timeLabel.setText(display);
}
然后绑定按钮：
dateToggleBtn.addActionListener(e -> {
showDate = !showDate;
updateTime(); // 立即刷新，避免等下一秒
});
注意：
- 不要在监听器里重复创建
DateTimeFormatter，它是线程安全且可复用的 -
showDate要声明为类字段（private boolean showDate = false;），否则每次点击都作用于新变量 - 切换后立刻调用
updateTime()，否则用户要等 1 秒才看到变化
关闭窗口时定时器没停止，导致应用无法退出
这是初学者最常忽略的问题：JVM 不会因为主窗口关闭就自动终止后台线程或 Timer。现象是关掉窗口后，进程仍在运行（Windows 任务管理器可见，macOS 可用 ps aux | grep java 查）。
解决方式不是调用 timer.stop() 就完事，而是确保在窗口真正销毁前清理：
frame.setDefaultCloseOperation(JFrame.DO_NOTHING_ON_CLOSE);
frame.addWindowListener(new WindowAdapter() {
@Override
public void windowClosing(WindowEvent e) {
timer.stop();
frame.dispose();
System.exit(0);
}
});
说明：
- 必须设为
DO_NOTHING_ON_CLOSE，否则默认行为会直接退出，来不及执行清理 -
timer.stop()是必须的，否则即使窗口关闭，Timer 仍会持续触发监听器（虽然 UI 已不存在，但可能引发空指针或日志刷屏） -
System.exit(0)在桌面应用中是安全的；Web 或模块化项目中应避免，但本场景适用
真正难的不是写完时钟，而是理解「谁在什么时候以什么身份修改了什么对象」。比如 timeLabel.setText() 看似简单，背后牵扯 EDT、组件生命周期、格式器缓存、定时器状态管理——漏掉任意一环，程序就可能静默异常或行为漂移。
