技能介绍

要解决什么问题

同一个 WPF 项目常常出现这些「不一致」：ViewModel 有的继承 BindableBase，有的用 Fody 特性；View 里按钮样式随手写死，偏离库默认风格；slnx 移个位置就 MSB3202 找不到项目；最麻烦的是 Python 项目往 C#/WPF 移植时，文本读写的行尾和 BOM 悄悄变了，输出文件字节级不一致。

这个技能把 GitPatchEditorWpf（Git Patch 编辑工具，由 Python/tkinter 移植为 C#/WPF）实战中踩过的坑沉淀成规范。

它是怎么工作的

骨架与依赖：slnx 放外层目录，项目目录扁平化；csproj 引入 WPFTemplateLib（NuGet 包，不复制源码）和 PropertyChanged.Fody，并配好 FodyWeavers.xml。
ViewModel 分层：轻量数据项用 SimpleBindableBase，复杂功能用 ViewModelBase；配合 Fody 织入，属性直接写自动属性，集合用 ObservableCollection，命令用 RelayCommand。
View 约定：每个 View 根元素加 d:DataContext 设计时声明，clr-namespace 必须映射项目实际命名空间；按钮不写 Style，交给 DefaultThemeDictionary 隐式接管；XAML 用 Grid 时除首个元素外都显式指定行列。
跨语言移植：先通读原项目源码再按 MVVM 分层实现，核心解析/生成逻辑保持字节级等价（保留原始行尾，读写用 UTF-8 无 BOM），最后用临时验证程序做输入输出比对。
验证闭环：dotnet build 要求 0 警告 0 错误，反射确认 INotifyPropertyChanged 织入，启动确认无 XamlParseException。

适用边界与注意点

面向 net472 或 net60 + UseWPF 的传统 WPF 桌面应用，不适用于 WinForms、UWP/WinUI 或 MAUI。
强绑定 WPFTemplateLib（dlgcy 维护，NuGet 官方源）和 PropertyChanged.Fody；若项目不用该样式库，View 与 App.xaml 部分需自行裁剪。
已知坑里最容易踩的是 App.xaml 被写出副本导致 x:Class 冲突、退出码 -532462766，需删 obj 残留后全量重建。