Java NetBeans Maven中JFrame无法加载按钮及面板问题求助

我在Java NetBeans Maven项目里开发一个带侧边栏按钮的JFrame，需求是通过侧边栏按钮切换右侧CardLayout容器中的不同JPanel。JFrame顶层采用GridBagLayout，首列放置切换按钮，右侧用CardLayout承载功能面板，但运行后所有组件都未加载显示。

已尝试调用repaint()、revalidate()、pack()，还在构造函数中添加测试JLabel，无论放在initComponents()前后都无法显示，怀疑构造函数未执行，但项目编译、运行均无报错，不知道该如何排查。

构造函数代码 #

public HomePage(LobbyList LL, UserList UL, User USER) {
    this.cardLayout = new CardLayout();
    this.gridBagLayout = new GridBagLayout();
    initComponents();
    SetLobbyList(LL);
    SetUserList(UL);
    SetUser(USER);
    CreatePanels();
}

相关面板变量声明 #

private JoinLobbyPanel JoinPanel; //add functionality by splitting up lobbypage
private NewLobbyPanel CreateLobby; // reference to the lobby creation page
private SearchUserPanel SearchUsers; // reference to the search user page
private JPanel cards; //contains the other functional JPanels
private final CardLayout cardLayout; //layout manager for cards
private final GridBagLayout gridBagLayout; //layout manager for grid
private JPanel grid; //contains the button components and the cards panel
private HomePanel HomePanel;

布局实现代码 #

private void CreatePanels(){
    JoinPanel = new JoinLobbyPanel(ll, ul, user);
    CreateLobby = new NewLobbyPanel(ll, ul, user);
    SearchUsers = new SearchUserPanel(ul);
    // lobbyPage = new LobbyPage(ll, ul, user);
    HomePanel = new HomePanel();
    cards = new JPanel();
    cards.setLayout(cardLayout);
    cards.add(JoinPanel, "Join Lobby");
    cards.add(CreateLobby, "Create Lobby");
    cards.add(SearchUsers, "Search Users");
    cards.add(HomePanel, "Home Page");
    cardLayout.show(cards, "Home Page");
    grid = new JPanel();
    grid.setLayout(gridBagLayout);
    GridBagConstraints gbc = new GridBagConstraints();
    JButton homeButton = new JButton();
    gbc.gridx=0;
    gbc.gridy=0;
    gbc.weighty=.5;
    gbc.gridwidth=1;
    gbc.gridheight=1;
    homeButton.addActionListener((java.awt.event.ActionEvent e) -> {
        cardLayout.show(cards, "Home Page");
    });
    grid.add(homeButton, gbc);
    JButton joinButton = new JButton();
    gbc.gridx=0;
    gbc.gridy=1;
    gbc.weighty=.5;
    gbc.gridwidth=1;
    gbc.gridheight=1;
    joinButton.addActionListener((java.awt.event.ActionEvent e) -> {
        cardLayout.show(cards, "Join Lobby");
    });
    grid.add(joinButton, gbc);
    JButton createButton = new JButton();
    gbc.gridx=0;
    gbc.gridy=2;
    gbc.weighty=.5;
    gbc.gridwidth=1;
    gbc.gridheight=1;
    createButton.addActionListener((java.awt.event.ActionEvent e) -> {
        cardLayout.show(cards, "Create Lobby");
    });
    grid.add(createButton, gbc);
    JButton searchButton = new JButton();
    gbc.gridx=0;
    gbc.gridy=3;
    gbc.weighty=.5;
    gbc.gridwidth=1;
    gbc.gridheight=1;
    searchButton.addActionListener((java.awt.event.ActionEvent e) -> {
        cardLayout.show(cards, "Search Users");
    });
    grid.add(searchButton, gbc);
    JButton logOutButton = new JButton();
    gbc.gridx=0;
    gbc.gridy=4;
    gbc.weighty=.5;
    gbc.gridwidth=1;
    gbc.gridheight=1;
    logOutButton.addActionListener((java.awt.event.ActionEvent e) -> {
        ul.test();
        SignInPage SI = new SignInPage(ul);
        SI.setVisible(true);
        this.dispose();
    });
    grid.add(logOutButton, gbc);
    gbc.fill=GridBagConstraints.BOTH;
    gbc.gridx=1;
    gbc.gridy=0;
    gbc.weighty=1;
    gbc.gridwidth=5;
    gbc.gridheight=5;
    grid.add(cards, gbc);
    this.add(grid);
    repaint();
    revalidate();
    this.pack();
}

排查与解决关键点 #

• 验证构造函数是否执行：在构造函数第一行添加System.out.println("HomePage构造函数已执行");，运行后查看控制台输出，直接确认构造函数是否被调用。
• 检查initComponents()的影响：NetBeans可视化生成的initComponents()可能已为JFrame设置默认布局（如BorderLayout）或添加了其他容器，导致手动添加的grid面板被覆盖。可以在initComponents()后打印System.out.println(this.getLayout());查看实际布局，或打开可视化编辑器确认JFrame的初始设置。
• 给按钮添加文本：当前创建的JButton都是空实例new JButton();，即使显示也无法看到，给每个按钮添加文本（如JButton homeButton = new JButton("首页");），方便调试时确认按钮是否存在。
• 修正GridBagLayout参数：
  • 侧边栏按钮未设置gbc.fill，可能被压缩成线，添加gbc.fill = GridBagConstraints.VERTICAL;让按钮纵向填充空间；
  • 右侧cards面板的gbc.gridwidth=5可改为gbc.gridwidth=GridBagConstraints.REMAINDER，自动占据剩余列；同时添加gbc.weightx = 1.0;，确保面板横向拉伸。
• 验证自定义面板：JoinLobbyPanel、HomePanel等自定义面板可能未正确初始化内部组件，可临时给HomePanel添加背景色或测试文本（如HomePanel = new HomePanel(){{setBackground(Color.RED); add(new JLabel("首页面板"));}};），确认面板是否正常加载。
• 确认窗口可见性：检查是否调用了HomePage.setVisible(true);，这是窗口显示的必要步骤，新手常遗漏。

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