IValueConverter必须实现Convert和ConvertBack两个方法，否则双向绑定失败；转换器需作为资源声明并正确引用，避免XAML实例化错误；调试应优先查看输出窗口Binding错误信息。
WPF中IValueConverter接口必须实现Convert和ConvertBack两个方法
不实现ConvertBack会导致双向绑定（如TextBox.Text）更新源失败，界面修改后属性值不变。即使你只用单向绑定，XAML解析器仍会检查该方法是否存在——留空或抛NotSupportedException是常见做法，但别直接删掉。
典型错误现象：BindingExpression path error 或修改控件后ViewModel属性没变化。
-
Convert用于从数据源（ViewModel）→ UI显示，参数value是绑定源的原始值，parameter可传入额外配置（比如格式字符串） -
ConvertBack用于UI输入 → 更新源，返回类型必须严格匹配绑定目标属性类型，否则触发InvalidOperationException - 若转换逻辑可能抛异常（如字符串转数字失败），应在
ConvertBack里捕获并返回Binding.DoNothing或默认值，避免绑定中断
在XAML中正确声明和引用转换器资源
转换器必须作为资源（ResourceDictionary项）定义，不能直接new在Binding里。常见错误是把转换器写成普通类实例，结果XAML报Cannot create instance of 'MyConverter'。
正确做法：在UserControl.Resources或Application.Resources中声明，用x:Key命名，再在Binding.Converter中引用。
<UserControl.Resources>
<local:BoolToVisibilityConverter x:Key="BoolToVis" />
</UserControl.Resources>
<Button Visibility="{Binding IsEnabled, Converter={StaticResource BoolToVis}}" />
- 确保命名空间声明正确：
xmlns:local="clr-namespace:YourApp.Converters" - 转换器类需有无参构造函数，否则XAML无法实例化
- 不要在转换器里访问UI线程控件（如
Application.Current.MainWindow），它可能被多个线程调用
多参数传递要用MultiBinding + IMultiValueConverter
IValueConverter只支持单个value，想根据两个属性（如IsChecked和HasError）共同决定按钮是否禁用？必须换用IMultiValueConverter。
错误做法：把第二个条件硬编码进转换器内部，导致复用性差、测试困难。
-
Convert接收object[] values，按MultiBinding中Binding的顺序排列 - 返回值类型由绑定目标决定（如
Button.IsEnabled需返回bool） -
ConvertBack在MultiBinding中极少使用，通常返回null或DependencyProperty.UnsetValue - 注意性能：每次任一绑定源变更都会触发整个
Convert，避免在其中做IO或复杂计算
调试转换器时优先检查Binding表达式输出窗口
WPF绑定失败不会抛异常，只会静默失败。打开Visual Studio「输出」窗口，筛选「Binding」，能看到类似System.Windows.Data Error: 23 : Cannot convert '' to type 'System.Boolean'的提示——这是最直接的线索。
- 在转换器方法开头加
Debugger.Break()，比打日志更可靠（尤其Release模式下） - 若
value为null，检查绑定路径是否拼错（如UserName写成Username）或源对象未初始化 - 自定义转换器若涉及文化信息（如日期格式），记得在
Convert中显式指定CultureInfo，别依赖当前线程Culture
真正麻烦的不是写不对，而是改完代码后忘了重新编译资源字典，或者XAML里StaticResource的key名和资源定义不一致——这种问题往往卡住半小时以上。
