Yii2.0.47优化AssetBundle策略以减少HTTP请求数、控制加载时机、避免重复引入并提升缓存命中率，核心围绕按需、可控、可维护展开，涵盖精简依赖、启用combo、条件注册、对接NPM等实践。
Yii2.0.47 中优化 AssetBundle 资源打包策略，核心目标是减少 HTTP 请求数、控制资源加载时机、避免重复引入，并提升缓存命中率。这不是简单合并文件，而是围绕“按需、可控、可维护”展开的工程实践。
精简依赖链，杜绝隐式冲突
很多项目在升级到 2.0.47 后出现 jQuery is not defined 或样式错乱，根源常是 $depends 声明不完整或存在循环依赖。建议：
- 每个自定义 AssetBundle 的 $depends 只声明直接且必需的父级 Bundle，不写冗余项（例如 AppAsset 不必再依赖 yii\web\JqueryAsset，若已通过 yii\web\YiiAsset 间接引入）
- 用 assetManager::bundles 配置全局禁用/替换，比如禁用默认 jQuery：
'yii\web\JqueryAsset' => false，改由 CDN 或自定义版本统一提供 - 检查依赖图谱：运行
php yii asset/combo --dry-run查看实际合并顺序，确认关键 JS 是否真在 CSS 之后、jQuery 确实在插件之前
启用资源组合与时间戳强制刷新
2.0.47 默认未开启自动合并（combo），需手动配置 assetManager：
- 在
config/web.php的components['assetManager']中添加：
'appendTimestamp' => true, —— 避免浏览器缓存旧版 CSS/JS
'forceCopy' => YII_DEBUG, —— 调试时跳过符号链接，确保修改实时生效
'bundles' => ['app\assets\AppAsset' => ['jsOptions' => ['position' => \yii\web\View::POS_END]]] —— 精确控制脚本位置 - 对静态资源较多的项目，启用 combo（需 Web 服务器支持重写）：
'enableCombo' => true,并配合 Nginx/Apache 规则将/assets/css/all.css?v=xxx转发到index.php?r=asset%2Fcombo
按场景条件注册，分离前后台资源
避免前台页面加载后台管理专用 JS，或移动端加载桌面端组件：
- 在视图中动态注册：
if (Yii::$app->request->isMobile) { MobileAsset::register($this); }if (Yii::$app->controller->id === 'admin') { AdminAsset::register($this); } - 创建专用 Bundle 类，如
FrontendAsset和BackendAsset，各自定义 $sourcePath 和 $js 子集，互不干扰 - 利用 publishOptions 过滤无用文件：
'publishOptions' => ['only' => ['css/*.css', 'js/*.js']]，防止 .map 或测试文件被发布
对接 NPM 与构建工具，脱离手工维护
2.0.47 完全支持 node_modules 资源直引，避免复制粘贴导致版本脱节：
- 在
AppAsset.php中设置：public $sourcePath = '@npm/bootstrap';public $css = ['dist/css/bootstrap.min.css'];public $js = ['dist/js/bootstrap.bundle.min.js']; - 确保
assetManager配置了'linkAssets' => true（开发环境）和'publishOptions' => ['forceCopy' => !YII_DEBUG]（生产环境） - 配合 webpack 构建后生成的 manifest.json，用自定义 AssetConverter 将
main.[hash].js映射为固定路径，实现长效缓存
