Mac M1 Pro运行Java Swing JPanel/JFrame延迟、渲染异常问题排查

1. 首先修复Swing线程违规问题 #

Swing的所有GUI操作必须在事件调度线程（EDT）执行，直接在main主线程初始化界面是MacOS（尤其是M系列芯片设备）下Swing出现卡死、不渲染、白屏的最常见原因。Windows下部分JDK会自动容错，但MacOS的渲染管线对线程合规性要求极高。

• 你现在的Main.java大概率是直接在main方法里new了TicTacToe实例，改成如下写法：

import javax.swing.*;

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

2. 调整setVisible的调用位置 #

• 你的代码在构造函数刚开始就调用了frame.setVisible(true)，此时窗口里还没添加任何组件，相当于先把空壳窗口提交给系统渲染，之后再往里面加组件很容易触发渲染管线死锁，导致组件不绘制、调整窗口大小时才触发重绘。
• 直接把frame.setVisible(true)这行移动到TicTacToe构造函数的最后一行，等所有组件添加、属性设置全部完成后再显示窗口。
• 教程的完整代码虽然也提前调用了setVisible，但后续添加按钮面板的操作刚好触发了全局重绘，所以没暴露问题，本质也是不规范写法。

3. 修复字体兼容问题 #

• 你代码里给标题设置的Ink Free是Windows系统专属自带字体，MacOS默认不预装该字体。Swing加载不存在的字体时会遍历系统所有字体做fallback匹配，这个过程在M系列芯片的Mac上会阻塞渲染线程几秒到几十秒，表现就是窗口白屏、转彩虹圈，等字体扫描完才显示文字。
• 临时验证可以先把textfield.setFont(...)这行注释掉，运行如果正常显示文字，就说明是字体问题，后续替换为MacOS自带的字体（比如PingFang SC、Helvetica、Arial）即可，也可以手动安装Ink Free字体解决。

4. 清理无效布局代码 #

• 你给title_panel设置的title_panel.setBounds(0,0,800,100)是无效代码，JFrame用的BorderLayout布局管理器会自动给NORTH区域的组件分配位置和大小，手动设置bounds会被布局忽略，反而可能干扰布局计算，直接删掉这行就行。

后续开发注意事项 #

教程里的firstTurn()方法直接调用Thread.sleep(2000)也是错误写法，等你写到这部分的时候，不要在EDT线程里做sleep、IO这类阻塞操作，否则会直接导致窗口无响应，阻塞逻辑要放到单独的工作线程，执行完再通过SwingUtilities.invokeLater()切回EDT更新界面。

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