需创建自定义Asset Bundle类并配置AssetManager组件以统一管理前端资源：定义AppAsset继承AssetBundle、设置sourcePath与css/js数组、注册到视图、配置assetManager的basePath/baseUrl/bundles等选项，并支持NPM包集成与条件注册。
如果您在Yii2项目中需要统一管理和优化前端资源（如CSS、JavaScript文件），则需正确配置Asset Bundle。以下是实现此目标的多种方法：
一、创建自定义Asset Bundle类
通过继承yii\web\AssetBundle类并定义资源路径与依赖关系，可声明一组前端资源及其加载规则。
1、在@app/assets目录下新建文件AppAsset.php。
2、在该文件中定义命名空间app\assets并继承yii\web\AssetBundle。
立即学习“前端免费学习笔记（深入）”；
3、设置$sourcePath指向本地资源目录，例如@app/web/assets或@npm/bootstrap。
4、在$css数组中添加CSS文件路径，如['css/site.css']。
5、在$js数组中添加JS文件路径，如['js/main.js']。
6、通过$depends指定依赖的其他Asset Bundle，例如[yii\web\YiiAsset::class]。
二、注册Asset Bundle到视图
在视图文件中调用register()方法，使资源被自动注入页面头部或尾部。
1、在视图PHP文件顶部使用use app\assets\AppAsset;引入类。
2、在视图开始处或需要位置调用AppAsset::register($this);。
3、确保$this为当前View对象实例，否则注册将无效。
4、注册后，该Bundle中定义的CSS会自动注入，JS默认注入页面底部。
三、配置AssetManager组件
通过修改config/web.php中的assetManager组件配置，可控制资源发布行为与路径映射。
1、在components数组中添加'assetManager' => ['class' => 'yii\web\AssetManager']。
2、设置'basePath'指定已发布资源的根目录，例如'@webroot/assets'。
3、设置'baseUrl'指定对应URL前缀，例如'@web/assets'。
4、配置'bundles'子数组以覆盖特定Bundle行为，如禁用jQuery：'yii\web\JqueryAsset' => false。
5、启用'appendTimestamp'为true可在URL末尾追加时间戳，强制浏览器重新加载更新后的资源文件。
四、使用NPM包作为Asset来源
将node_modules中的第三方库纳入Asset管理，避免手动复制文件。
1、确保项目根目录已运行npm install bootstrap等命令安装所需包。
2、在Asset Bundle类中将$sourcePath设为@npm/bootstrap。
3、在$css中引用dist/css/bootstrap.min.css，在$js中引用dist/js/bootstrap.min.js。
4、确认AssetManager的linkAssets选项为true，启用符号链接而非复制文件，提升开发效率。
5、若部署环境不支持符号链接，应将linkAssets设为false并确保publish机制正常工作。
五、按条件注册不同Asset Bundle
根据运行环境、用户角色或请求参数动态选择加载的资源包。
1、在控制器动作中判断条件，例如Yii::$app->request->isAjax。
2、在视图中使用if语句分支注册不同Bundle，如AdminAsset::register($this)或GuestAsset::register($this)。
3、在Asset Bundle类的init()方法中根据Yii::$app->user->isGuest动态设置$css或$js数组内容。
4、利用yii\web\View::POS_HEAD或POS_END参数控制JS插入位置，避免因执行时机导致的脚本错误。
