JavaFX TableView添加行时整体刷新致性能问题的解决方案咨询

嗨，这个问题我之前做JavaFX项目时也碰到过，其实完全可以实现只添加单行而不刷新整个TableView，核心在于正确使用数据源和添加方式，下面给你一步步拆解解决方案：

1. 必须用ObservableList作为TableView的数据源 #

JavaFX的ObservableList是专门为UI绑定设计的列表，它会自动向TableView发送局部更新通知，而不是触发全量刷新。你应该用FXCollections.observableArrayList()来初始化数据列表，而非普通的ArrayList。

2. 直接向ObservableList添加行，不要重新设置Items #

很多人踩坑的原因是添加新行时重新调用tableView.setItems(newList)，这会让TableView认为整个数据源被替换，从而重新渲染所有行。正确的做法是直接调用ObservableList的add()或addAll()方法：

import javafx.application.Application;
import javafx.beans.property.SimpleStringProperty;
import javafx.collections.FXCollections;
import javafx.collections.ObservableList;
import javafx.scene.Scene;
import javafx.scene.control.ScrollPane;
import javafx.scene.control.TableColumn;
import javafx.scene.control.TableView;
import javafx.scene.layout.VBox;
import javafx.stage.Stage;

public class TableViewAddRowDemo extends Application {

    @Override
    public void start(Stage stage) {
        // 初始化ObservableList数据源
        ObservableList<DataModel> data = FXCollections.observableArrayList();
        // 先添加一些初始数据
        for (int i = 0; i < 20; i++) {
            data.add(new DataModel("初始数据" + i, "描述" + i));
        }

        // 创建TableView和列
        TableView<DataModel> tableView = new TableView<>();
        tableView.setItems(data);

        TableColumn<DataModel, String> col1 = new TableColumn<>("列1");
        col1.setCellValueFactory(cellData -> cellData.getValue().col1Property());

        TableColumn<DataModel, String> col2 = new TableColumn<>("列2");
        col2.setCellValueFactory(cellData -> cellData.getValue().col2Property());

        tableView.getColumns().addAll(col1, col2);

        // 监听ScrollPane滚动事件，到底部时添加新行
        ScrollPane scrollPane = new ScrollPane(tableView);
        scrollPane.vvalueProperty().addListener((obs, oldVal, newVal) -> {
            if (newVal.doubleValue() == 1.0) { // 滚动到垂直底部
                // 关键：直接向ObservableList添加单行，不会触发全量刷新
                data.add(new DataModel("新行" + data.size(), "新描述" + data.size()));
            }
        });

        VBox root = new VBox(scrollPane);
        Scene scene = new Scene(root, 400, 300);
        stage.setScene(scene);
        stage.show();
    }

    // 自定义数据模型，必须用JavaFX的Property类型
    public static class DataModel {
        private final SimpleStringProperty col1;
        private final SimpleStringProperty col2;

        public DataModel(String col1, String col2) {
            this.col1 = new SimpleStringProperty(col1);
            this.col2 = new SimpleStringProperty(col2);
        }

        public String getCol1() { return col1.get(); }
        public void setCol1(String value) { col1.set(value); }
        public SimpleStringProperty col1Property() { return col1; }

        public String getCol2() { return col2.get(); }
        public void setCol2(String value) { col2.set(value); }
        public SimpleStringProperty col2Property() { return col2; }
    }

    public static void main(String[] args) {
        launch(args);
    }
}

3. 确保数据模型使用JavaFX Property类型 #

你的数据类必须用SimpleStringProperty（或其他对应Property类型，比如SimpleIntegerProperty）定义字段，并且提供xxxProperty()方法。这样不仅能保证添加新行时的局部更新，后续修改行数据时也不会触发整行甚至全表的刷新。

4. 避免不必要的强制刷新 #

绝对不要调用tableView.refresh()，这个方法会强制TableView重新渲染所有行，完全是画蛇添足，会直接导致你遇到的性能问题。

为什么这样做有效？ #

ObservableList在调用add()时，会触发ListChangeListener的通知，TableView接收到这个通知后，只会创建新行的UI组件并添加到表格中，不会重新渲染已有的行。这样即使数据量很大，新增行的操作也会非常流畅。

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