WPF ListBox绑定对象不显示是因默认调用ToString()且未重写，解法为设置DisplayMemberPath或ItemTemplate；SelectedItem异常需确保ObservableCollection和正确检查索引；性能问题靠虚拟化和避免外层ScrollViewer解决。
WPF 中的 ListBox 不是 WinForms 那个“拿来就用”的简单控件，它默认不自动显示对象的字符串表示，绑定复杂对象时容易空着不显示——这是最常踩的第一个坑。
为什么 ListBox 绑定对象后什么也不显示？
根本原因是 WPF 的 ListBox 默认调用对象的 ToString() 方法生成显示文本，而自定义类通常没重写这个方法，结果只显示类型全名（如 MyApp.Models.User）。
- 最直接的解法：设置
DisplayMemberPath属性，指定要显示的公共属性名，比如DisplayMemberPath="Name" - 更灵活的做法：用
ItemTemplate自定义模板，支持多字段、图标、条件样式等，例如：<ListBox.ItemTemplate> <DataTemplate> <StackPanel Orientation="Horizontal"> <TextBlock Text="{Binding Name}" FontWeight="Bold"/> <TextBlock Text=" - " /> <TextBlock Text="{Binding Age}" Foreground="Gray"/> </StackPanel> </DataTemplate> </ListBox.ItemTemplate> - 注意：
DisplayMemberPath和ItemTemplate不能同时生效，后者优先级更高
SelectedItem 和 SelectedItems 返回 null 或行为异常？
常见于绑定 ObservableCollection<t></t> 后手动修改集合（如 .RemoveAt()），但 UI 没同步更新，导致选中项索引错位或引用失效。
- 务必确保数据源实现了
INotifyCollectionChanged（ObservableCollection<t></t>已内置） - 避免直接操作
Items集合（listBox.Items.Add()），这会绕过数据绑定，破坏一致性 - 读取选中项时，先检查
SelectedIndex != -1（单选）或SelectedItems.Count > 0（多选），再取值，否则可能抛NullReferenceException - 多选模式下，
SelectedItems是只读集合，不能直接 Add/Remove；如需修改选中状态，请操作ListBoxItem.IsSelected或使用 MVVM 的ICollectionView处理
滚动卡顿、加载慢，大数据量怎么办？
默认情况下，WPF ListBox 会对每个可见项生成完整的 UI 元素（ListBoxItem），1000 条数据就会创建 1000 个对象——内存和渲染压力都大。
- 开启虚拟化：确保
VirtualizingStackPanel.IsVirtualizing="True"（默认开启），并避免在ListBox外层套ScrollViewer，否则会禁用虚拟化 - 禁用不必要的功能：设
ScrollViewer.CanContentScroll="True"（默认），并避免在ItemTemplate中使用高度不确定的控件（如TextBlock未设MaxHeight） - 极端场景可启用分页或懒加载：监听
ScrollViewer.ScrollChanged事件，在接近底部时追加新数据
SelectionMode 设置无效或双击不响应？
SelectionMode 必须在绑定数据前设置，否则部分模式（如 MultiExtended）可能被忽略；而双击事件默认不触发，需要显式启用。
- 设置顺序很重要：先
listBox.SelectionMode = SelectionMode.MultiExtended;，再listBox.ItemsSource = data; - 双击事件不是
ListBox原生事件，要用MouseDoubleClick（WPF）或监听子项的PreviewMouseDoubleClick，并在事件处理中通过OriginalSource找到对应数据项 - 键盘选择（Shift+方向键、Ctrl+单击）依赖焦点和
KeyboardNavigation行为，若 ListBox 失去焦点，这些操作会失效；确保Focusable="True"且未被父容器拦截键盘事件
真正难的不是怎么写出来，而是意识到 ListBox 在 WPF 里本质是个“数据驱动的容器”，它的行为几乎全部由绑定源、模板和虚拟化策略共同决定——漏掉其中一环，UI 就可能静默失败。
