Yii框架不打包前端资源，仅管理已构建的静态文件；需创建AssetBundle类定义资源路径与依赖，显式调用AppAsset::register($this)注册生效，依赖顺序由$depends控制，生产环境应禁用动态发布并配合CDN与构建工具协同。
Yii 框架本身不打包前端资源，它只负责“发布”和“管理”已存在的静态文件；真正打包压缩（如合并 JS/CSS、生成哈希名、编译 Sass）得靠 Webpack/Vite 等构建工具，Yii 的 AssetBundle 是在构建产物生成后，把它们“挂载”到页面上的桥梁。
AssetBundle 怎么注册并生效
注册不是自动的，必须显式调用 AppAsset::register($this) 才会把 CSS/JS 插入页面。常见错误是只写了类定义但忘了注册，结果页面空荡荡没样式也没脚本。
- 必须在视图文件（如
views/site/index.php）顶部或合适位置调用register()，参数是当前$this（即View对象） - 如果注册了多个 Bundle，
$depends决定加载顺序：比如yii\web\JqueryAsset必须在你自定义的 JS 之前加载，否则报jQuery is not defined -
$basePath是服务器物理路径（如@webroot/assets），$baseUrl是对应可访问 URL（如/assets或https://static.example.com），两者要匹配，否则 404
assetManager 配置影响资源发布行为
assetManager 组件控制资源如何从源目录复制到 Web 可访问目录，默认行为是每次首次访问时自动发布，但生产环境应禁用动态发布，改用预发布。
- 开发时设
'forceCopy' => true可绕过时间戳比对，强制重发——适合频繁改 CSS/JS 调试 - 生产环境务必设
'linkAssets' => true（Linux）或'symlink' => true（macOS），避免重复拷贝，提升性能 - 若用 CDN，直接在
assetManager中设'baseUrl' => YII_ENV_PROD ? 'https://static.example.com' : '@web'，但注意：CDN 域名不能带路径后缀，如https://static.example.com/cdn会导致内部拼接出错 - 第三方 Bundle（如
yii2-grid）可能硬编码baseUrl，需在assetManager['bundles']中单独覆盖：'kartik\grid\GridViewAsset' => ['baseUrl' => 'https://static.example.com']
怎么让构建工具产出和 Yii 的 asset 发布不冲突
前后端分离项目里，Vite/Webpack 打包输出的 dist/ 目录就是最终静态资源，Yii 不该再“发布”一遍，否则多一层拷贝、多一个缓存失效点。
PigX UI 前端开发
下载
PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。
立即学习“前端免费学习笔记（深入）”；
- 关闭
assetManager的自动发布：设'publishOptions' => ['forceCopy' => false]，并确保所有资源路径都指向构建产物目录（如'basePath' => '@webroot/../dist'） - Vite 构建时设
base: '/'（根部署）或base: '/myapp/'（子路径），然后 Yii 的$baseUrl必须与之完全一致，否则css/app.css实际请求变成/assets/css/app.css而不是/css/app.css - 如果构建产物用了哈希文件名（如
main.a1b2c3.js），别手动写进$js数组——改用assetMap映射：'assetMap' => ['js/main.js' => 'js/main.a1b2c3.js']
CDN 场景下容易忽略的三个实际问题
光改 baseUrl 不够，浏览器和 CDN 本身会制造新问题。
- 混合内容警告：生产环境用了 HTTPS CDN，但开发环境还用 HTTP 的
@web，某些浏览器会拦截非 HTTPS 的资源请求——统一用//static.example.com协议相对地址更稳妥 - 缓存击穿：CDN 缓存了
app.css，你更新了内容但没改文件名，用户看到旧样式——必须配合构建工具生成哈希文件名，或启用assetManager['appendTimestamp'] = true（但注意 CDN 可能忽略查询参数） - 资源上传遗漏：CDN 控制台配置了回源，但你只上传了
dist/js和dist/css，漏了dist/fonts或图片，结果页面字体图标或 banner 图 404——上线前用find dist -type f核对文件树完整性
最麻烦的不是配置本身，而是构建产物路径、Yii 发布路径、CDN 回源路径、Nginx 静态服务路径这四者之间任何一环不严丝合缝，都会导致资源 404。建议上线前用浏览器 DevTools 的 Network 面板逐个确认每个 .js .css 请求的真实 URL 和响应状态。
