在Avalonia中，
FindControl<t>()</t>是最常用、最直接的控件查找方式，用于在XAML定义的UI树中按名称定位控件实例。它必须在控件已加载（即
InitializeComponent()已执行、可视化树已构建）之后调用，否则返回
null。
控件必须先设置 Name 属性
Avalonia 不支持 WPF 那样的“自动字段生成”（如自动生成
private Button myButton;），所有需要代码访问的控件，都必须在 XAML 中显式设置
Name属性：
<button name="saveBtn" content="保存"></button>
<textbox name="inputBox"></textbox>
<mapcontrol name="mapCtl"></mapcontrol>（如 Mapsui 场景）
在后台代码中安全调用 FindControl
推荐在
OnLoaded事件或
InitializeComponent()之后调用，确保 UI 已完成初始化： 在构造函数中调用前，务必先执行
InitializeComponent()若不确定是否已加载，可加空值判断：
var btn = this.FindControl<button>("saveBtn"); if (btn != null) { ... }</button>
类型参数 T必须与目标控件的实际类型一致，否则返回
null（不抛异常）
支持嵌套查找和泛型约束
FindControl默认只在当前控件的直接子元素中搜索；如需跨层级查找，可链式调用或使用更明确的路径：
this.FindControl<grid>("mainGrid")?.FindControl<textbox>("inputBox")</textbox></grid>
也可用 Templates或
VisualTreeHelper遍历，但日常开发中极少需要——命名+层级结构已覆盖绝大多数场景 注意：不能通过类名（如
FindControl<button>()</button>不带名称）批量查找，必须指定
Name
常见错误提醒
以下写法容易出错，需避免：
XAML 中漏写Name，只写
x:Name（Avalonia 不识别
x:Name，只认
Name） 在
InitializeComponent()前调用
FindControl类型不匹配，例如把
TextBlock当作
Label查找（Avalonia 中没有
Label，常用的是
TextBlock或
ContentControl） 拼写错误：XAML 中是
Name="mapCtl"，代码里写成
"mapControl"
