Widget::widget() 是 Yii2 小部件的唯一推荐调用方式，它自动完成实例化、init() 和 run()，返回 HTML 字符串；必须传入合法 public 属性，否则静默丢弃，且需显式注入视图中渲染。
直接调用 Widget::widget() 是最常用方式
Yii2 中小部件不是靠“注册”或“引入类”再实例化，而是统一走静态工厂方法 Widget::widget()。它内部自动完成实例化、运行 init() 和 run()，最后返回渲染结果（字符串）。
常见错误是试图 new 一个 Widget 类再手动调用方法，这会跳过 Yii 的生命周期钩子，导致配置不生效、事件不触发、视图路径错乱。
-
Widget::widget()必须在控制器的 action 方法里调用，且只能返回字符串 —— 你得把它塞进return $this->render(...)的数据中，不能直接 echo 或 return 它 - 参数必须是关联数组，键名对应 Widget 类的 public 属性（比如
Alert小部件有$options、$body），拼错属性名不会报错，只是被忽略 - 如果 Widget 依赖视图文件（如
yii\widgets\MaskedInput不依赖，但yii\bootstrap4\Alert依赖），确保viewPath正确或使用默认路径；否则渲染为空
传参时注意 $config 和 $view 的作用边界
小部件构造本质是两阶段：先用 $config 初始化属性，再在 run() 中读取这些属性去生成 HTML。但有些属性（比如 $view）只在渲染阶段起作用，不能靠 $config 传进去就完事。
典型例子是自定义 Alert 小部件视图：'view' => 'alert-custom' 是合法的，但如果你写成 'customView' => 'alert-custom'（而 Widget 类没声明该 public 属性），这个值就丢了。
- 所有传入
Widget::widget([...])的键，必须是 Widget 类中定义为public $xxx的属性，否则静默丢弃 -
$view是很多内置 Widget（如Alert、ActiveForm）预留的属性，用于指定渲染模板，它不参与逻辑处理，只影响最终输出结构 - 不要在
$config里传函数或闭包 —— 大部分 Widget 不支持序列化回调，会抛Serialization of 'Closure' is not allowed
在控制器里渲染小部件，别忘了它返回的是字符串
很多人卡在这一步：写了 Widget::widget([...])，页面却没显示，或者显示一堆 object 字符串。根本原因是没把返回值正确注入到视图中。
Widget 渲染结果是纯 HTML 字符串，不是响应对象，也不是视图变量自动绑定。你必须显式把它作为数据传给 $this->render()。
- 错误写法：
Widget::widget(['class' => 'yii\bootstrap4\Alert', 'body' => 'Hi']); return $this->render('index');—— Alert 字符串被丢弃了 - 正确写法：
return $this->render('index', [ 'alertHtml' => Widget::widget([ 'class' => 'yii\bootstrap4\Alert', 'body' => 'Hi' ]) ])，然后在index.php里写= $alertHtml ?> - 也可以在视图里直接调用（更常见），但控制器里调用适合需要预处理数据、做权限判断后再决定是否渲染的场景
自定义 Widget 在控制器中调用的兼容性要点
自己写的 Widget 如果在控制器里调用失败，90% 出在 init() 或 run() 里用了 $this->view 但没初始化，或者依赖了未注入的组件（如 $this->getView() 返回 null）。
Yii 控制器调用 Widget 时，不会自动设置 $this->view，除非你在 run() 中显式调用 $this->getView()（它会懒加载）。
- 避免在
init()中直接访问$this->view->registerJs()—— 此时$this->view可能还是 null - 如果 Widget 需要注册 JS/CSS，把相关逻辑挪到
run()开头，用$view = $this->getView(); $view->registerJs(...) - 检查命名空间和 use 语句是否正确，控制器里调用
app\widgets\MyWidget::widget()时，别漏掉use app\widgets\MyWidget;，否则报Class 'MyWidget' not found
