切换TableColumn可见性会重置宽度，setPrefWidth无法生效

我之前也碰到过一模一样的情况——JavaFX的TableColumn在隐藏后重新显示时，会自动覆盖你之前设置的宽度，哪怕调用setPrefWidth好像也没效果。这是因为列的可见性变化会触发布局系统重新计算列宽，默认会用内容自适应或者内置的默认宽度值，把你之前的设置冲掉。下面是我亲测有效的解决思路和代码：

核心思路 #

1. 提前保存初始宽度：在UI初始化完成、数据填充完毕后，把每一列（包括嵌套的子列）的初始prefWidth都存起来，相当于做个快照。
2. 监听可见性变化，自动恢复宽度：给所有列添加可见性监听，当列从隐藏变为可见时，把之前保存的宽度重新设置回去，同时固定最小/最大宽度，防止布局系统再次自动调整。
3. 配合上下文菜单动作：在“显示所有列”的动作里，也触发宽度恢复逻辑，确保批量显示时所有列都能回到初始宽度。

代码实现 #

第一步：保存初始列宽 #

首先，在你的UI控制器初始化完成、数据加载到TableView之后，调用下面的方法保存所有列（包括子列）的宽度：

import javafx.scene.control.TableColumn;
import javafx.scene.control.TableView;
import java.util.HashMap;
import java.util.Map;

// 定义一个全局的Map来存列和对应的初始宽度
private Map<TableColumn<?, ?>, Double> columnWidthSnapshot = new HashMap<>();

private void saveInitialColumnWidths(TableView<?> tableView) {
    // 遍历所有顶级列，递归处理子列
    for (TableColumn<?, ?> column : tableView.getColumns()) {
        saveColumnWidthRecursively(column);
    }
}

private void saveColumnWidthRecursively(TableColumn<?, ?> column) {
    // 保存当前列的prefWidth
    columnWidthSnapshot.put(column, column.getPrefWidth());
    // 递归处理嵌套的子列
    for (TableColumn<?, ?> subColumn : column.getColumns()) {
        saveColumnWidthRecursively(subColumn);
    }
}

第二步：给列添加可见性监听 #

接下来，给所有列添加监听，当列变为可见时自动恢复宽度：

private void setupColumnVisibilityListeners(TableView<?> tableView) {
    for (TableColumn<?, ?> column : tableView.getColumns()) {
        setupColumnListenerRecursively(column);
    }
}

private void setupColumnListenerRecursively(TableColumn<?, ?> column) {
    column.visibleProperty().addListener((observable, oldVisible, newVisible) -> {
        if (newVisible && columnWidthSnapshot.containsKey(column)) {
            // 恢复保存的初始宽度
            double savedWidth = columnWidthSnapshot.get(column);
            column.setPrefWidth(savedWidth);
            // 固定最小和最大宽度，防止布局系统自动调整
            column.setMinWidth(savedWidth);
            column.setMaxWidth(savedWidth);
            // 强制触发TableView的布局更新，确保宽度生效
            tableView.requestLayout();
        }
    });
    // 给子列也添加监听
    for (TableColumn<?, ?> subColumn : column.getColumns()) {
        setupColumnListenerRecursively(subColumn);
    }
}

第三步：配合上下文菜单动作 #

在你的“显示所有列”菜单事件里，调用批量显示并恢复宽度的方法：

// 假设这是你的“显示所有列”菜单项的事件处理
showAllColumnsMenuItem.setOnAction(event -> {
    showAllColumnsRecursively(tableView.getColumns());
});

private void showAllColumnsRecursively(java.util.List<TableColumn<?, ?>> columns) {
    for (TableColumn<?, ?> column : columns) {
        column.setVisible(true);
        // 这里因为我们已经加了可见性监听，所以宽度会自动恢复，
        // 如果你想更稳妥，也可以在这里手动再设置一次宽度
        if (columnWidthSnapshot.containsKey(column)) {
            double savedWidth = columnWidthSnapshot.get(column);
            column.setPrefWidth(savedWidth);
            column.setMinWidth(savedWidth);
            column.setMaxWidth(savedWidth);
        }
        // 递归处理子列
        showAllColumnsRecursively(column.getColumns());
    }
    // 最后强制更新布局
    tableView.requestLayout();
}

// “隐藏列”的事件处理可以保持不变，只需要设置列不可见即可
hideColumnMenuItem.setOnAction(event -> {
    // 这里需要实现获取当前选中的列的逻辑，比如通过右键点击的位置获取
    TableColumn<?, ?> selectedColumn = getSelectedColumnFromContextMenu();
    if (selectedColumn != null) {
        selectedColumn.setVisible(false);
    }
});

关键说明 #

• 为什么之前调用setPrefWidth没用？因为列重新显示时，JavaFX的布局系统会先执行自动宽度计算，把你的设置覆盖掉。所以我们需要同时设置minWidth和maxWidth和prefWidth一致，把宽度固定死。
• 一定要在数据填充完成后再保存初始宽度，因为数据填充后列的默认宽度才会稳定下来。
• 如果你的列宽度可能在使用过程中被用户手动调整，你可以在用户调整宽度时更新columnWidthSnapshot里的值，这样恢复的就是用户最后设置的宽度，而不是初始值。

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