Yii 2 默认不带 Bootstrap，但官方提供 BootstrapAsset 资源包支持；集成需匹配版本（Bootstrap 3 用 yii2-bootstrap，4/5 用 yii2-bootstrap4/5），推荐通过 Composer 安装并依赖自动注入，避免手动引入。
Yii 2 默认不带 Bootstrap，但官方提供了 yii\bootstrap\BootstrapAsset 和 yii\bootstrap4\BootstrapAsset 两类资源包，集成方式取决于你用的是 Bootstrap 3 还是 Bootstrap 4/5，以及是否使用 Composer 管理依赖。手动复制 CSS/JS 文件或硬编码 register() 的做法在现代 Yii 项目中已不推荐，容易导致版本混乱、CDN 失效、响应式失效等问题。
确认 Yii 版本和 Bootstrap 目标版本
这是最容易跳过的一步，但直接决定后续所有操作是否有效：
- Yii 2.0.x（如 2.0.45）默认只支持 Bootstrap 3，对应扩展是
yiisoft/yii2-bootstrap（已归档） - Yii 2.0.46+ 或 Yii 3.x 支持 Bootstrap 4/5，应使用
yiisoft/yii2-bootstrap4或yiisoft/yii2-bootstrap5 - 运行
composer show yiisoft/yii2查看实际版本；检查vendor/yiisoft下是否存在yii2-bootstrap4目录 - 若项目里已有
yii\bootstrap\BootstrapAsset类但报错 “Class not found”，大概率是用了新 Yii 却没装对应扩展
用 Composer 安装并注册 Bootstrap 资源包
不要下载 ZIP、不要放 protected/extensions、不要改 main.php 的 preload —— Yii 2.0.12 之后的推荐路径是资源包（Asset Bundle）+ 自动依赖注入：
- 安装命令（以 Bootstrap 4 为例）：
composer require "yiisoft/yii2-bootstrap4:^2.0" - 确保
config/web.php中components['view']已配置 theme（否则组件样式不生效）：'view' => [ 'theme' => [ 'pathMap' => ['@yii/views' => '@vendor/yiisoft/yii2-theme-bootstrap4'], ], ], - 不需要在
AppAsset.php里手动加'yii\bootstrap4\BootstrapAsset'—— 只要视图中用了ActiveForm或Alert等组件，它会自动按需加载 - 如果必须强制全局加载（比如自定义 JS 依赖 Bootstrap 的
data-toggle），才在AppAsset.php的$depends中显式添加：'yii\bootstrap4\BootstrapAsset'
视图中正确调用 Bootstrap 组件（不是写 HTML class）
很多人以为加了 btn btn-primary 就算集成成功，其实那只是静态样式；真正集成是指能用 Yii 封装的 PHP 组件，自动处理 CSRF、表单验证、AJAX 渲染等逻辑：
立即学习“前端免费学习笔记（深入）”；
- 按钮别写
<button class="btn btn-primary">提交</button>，改用：Html::button('提交', ['class' => 'btn btn-primary']) - 表单别手写
<form><input></form>，改用：$form = ActiveForm::begin(['options' => ['class' => 'needs-validation']]); echo $form->field($model, 'email')->textInput(['required' => true]); ActiveForm::end();
- 警告框别用
<div class="alert alert-info">...</div>，改用：Alert::widget(['options' => ['class' => 'alert-info'], 'body' => '操作成功']) - 注意：这些组件的 class 名（如
alert-info）由 Bootstrap 主题控制，若换成了 Bootstrap 5，alert-info可能变成bg-info text-white—— 这就是为什么不能绕过组件直接写 HTML
常见报错与定位方法
遇到问题时，先看浏览器 Network 面板是否加载了 bootstrap.min.css 和 bootstrap.bundle.min.js，再查控制台错误：
-
Uncaught TypeError: $(...).modal is not a function→ jQuery 未加载或重复加载；检查是否同时引入了yii\web\JqueryAsset和其它 jQuery（如 CDN） -
Class 'yii\bootstrap4\BootstrapAsset' not found→ 扩展未安装，或use yii\bootstrap4\BootstrapAsset;缺失，或命名空间拼错（注意是bootstrap4不是bootstrap） - 按钮有样式但点击无反应 → 检查
bootstrap.bundle.min.js是否加载成功（Network 中状态码是否为 200），以及是否漏了data-bs-*属性（Bootstrap 5 要求，不再是data-toggle） - 表单验证提示文字不显示 → 确认
$form->field()内部是否调用了errorSummary或启用了enableClientValidation
最常被忽略的一点：Bootstrap 的 JavaScript 插件（如 Tooltip、Popover）依赖 Popper.js，在 Bootstrap 4/5 中已打包进 bootstrap.bundle.min.js；如果你只引用了 bootstrap.min.js，这些组件必然失效，且控制台不会报明显错误。
