JavaFX ChoiceBox数据存在但不显示文本问题求助

这种情况我碰到过好多次，大概率是FXML绑定或者数据设置的环节出了小问题，结合你给出的代码片段，给你几个排查和解决的方向：

1. 检查FXML与代码的fx:id绑定是否匹配 #

这是最常见的坑！你代码里的@FXML private ChoiceBox<String> shapes;对应的FXML文件里的ChoiceBox，必须保证fx:id属性和变量名完全一致（Java是大小写敏感的，别写错大小写或者拼写）。

比如FXML里的写法应该是这样：

<ChoiceBox fx:id="shapes" layoutX="20" layoutY="20" />

如果FXML里写的是fx:id="shape"或者Fx:id="shapes"，都会导致绑定失败，你的代码操作的其实是一个未关联界面的空实例，自然界面不会显示内容。

2. 确保操作的是FXML绑定的ChoiceBox实例 #

从你的代码片段看，你在start方法里用FXMLLoader加载了FXML，但如果直接在start里操作shapes变量是没用的——因为@FXML标注的变量是属于FXML对应的控制器类的，不是主类的变量。

正确的做法是通过FXMLLoader获取控制器实例，再操作里面的shapes：

@Override
public void start(Stage primaryStage) throws Exception {
    FXMLLoader loader = new FXMLLoader();
    loader.setLocation(getClass().getResource("/canvas.fxml"));
    Parent root = loader.load();
    
    // 获取FXML对应的控制器实例
    YourController controller = loader.getController();
    
    // 往控制器里的shapes添加数据
    ObservableList<String> shapeOptions = FXCollections.observableArrayList("Circle", "Rectangle", "Triangle");
    controller.shapes.setItems(shapeOptions);
    
    primaryStage.setScene(new Scene(root));
    primaryStage.show();
}

3. 推荐在控制器的初始化方法里设置数据 #

更规范的做法是在控制器的initialize方法里初始化ChoiceBox的数据，这样能确保FXML加载完成后自动执行初始化逻辑：

public class YourController implements Initializable {
    @FXML private ChoiceBox<String> shapes;

    @Override
    public void initialize(URL location, ResourceBundle resources) {
        // 初始化数据
        ObservableList<String> shapeOptions = FXCollections.observableArrayList("Circle", "Rectangle", "Triangle");
        shapes.setItems(shapeOptions);
        
        // 验证数据是否存入（你说能打印，这里可以确认）
        System.out.println("ChoiceBox数据：" + shapes.getItems());
    }
}

如果用的是JavaFX 8及以上版本，也可以用@PostConstruct注解代替实现Initializable接口，效果是一样的。

4. 确认使用ObservableList存储数据 #

虽然普通的ArrayList也能通过FXCollections.observableList()转成ObservableList，但直接用FXCollections.observableArrayList()创建列表是最优的——因为它是JavaFX的响应式集合，能自动通知界面更新数据变化。如果用普通集合，可能会出现数据存入但界面没感知的情况。

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