用途:在应用构建通过后、提交前对 WinUI 3 项目进行代码审查,发现不是编译错误、也不易被 UI 测试覆盖的质量问题,例如能编译运行但错误、脆弱或缓慢的写法。
主要能力:审查 XAML 与 C# 文件,检查 MVVM 合规(ViewModel 继承 ObservableObject、使用 [ObservableProperty] partial 属性与 [RelayCommand]、ViewModel 中不含 UI 类型与业务逻辑)、x:Bind 与数据绑定(已知源类型优先 x:Bind、DataTemplate 使用 x:DataType、避免嵌套可空路径)、无障碍(交互控件加 AutomationProperties.AutomationId、纯图标按钮加 Name、语义控件、不以颜色单独传达信息)、主题(使用 ThemeResource 与内置文本样式、4px 间距网格、ControlCornerRadius)、安全(源码不含密钥、不直接使用未净化输入做 Process.Start 或文件删除写入)、性能(长列表用虚拟化 ListView/GridView、x:Load、重活移出 UI 线程、避免 .Result/.Wait()、释放可弃置对象)、全球化和 Native AOT/裁剪相关检查。分析器按 WUI0xxx 至 WUI4xxx 分类检测兼容性、迁移提示、运行时与布局陷阱、MVVM 模式及互操作问题。
使用方式:阅读项目 XAML 与 C# 文件逐项检查。报告 API 不匹配或建议替换前,用 CLI 0.7+ 的 winapp find-api 对照已还原的应用项目引用验证,例如 winapp find-api members NavigationView --filter selected --json --project-dir <app-project-dir>。分析器设置参见 winui-dev-workflow,未安装时需告知用户相关检查未运行。修复根因,确需抑制误报时应范围狭窄且有文档说明,不宜整体 NoWarn;保留 IL/CsWinRT 警告开启。审查后按文件、行号、严重级别(Error/Warning/Note)汇总问题并给出具体修改建议。
限制:本资料未提供平台与价格信息。