sourcePath 必须是相对于应用基目录的真实文件系统路径，如 @app/resources，且需包含 css/、js/ 子目录；JS 依赖问题主因是加载顺序错误，须确保 depends 中声明 yii\web\JqueryAsset::class 并检查 HTML 中 script 标签顺序。
AssetBundle 类定义里 sourcePath 为什么总报“Directory does not exist”？
因为 Yii 不会自动把 Web 可访问目录（如 web/）当作资源根目录，sourcePath 必须是相对于应用基目录的**真实文件系统路径**，且该路径下必须存在 css/、js/ 等子目录才能被识别。
-
sourcePath写成@web/assets或/assets—— 错，这是 URL 路径，不是文件路径 - 正确写法是
@app/resources或__DIR__ . '/../resources'，且确保该目录下有css/site.css这类实际文件 - 如果资源在扩展里（比如
vendor/yiisoft/yii2-bootstrap4），要用@vendor/yiisoft/yii2-bootstrap4/assets，不能漏掉assets子目录 - 开发时改了
sourcePath但没清缓存？执行php yii asset/compress或删掉web/assets/目录再试
怎么让 CSS/JS 只在某个页面加载，而不是全站？
Yii 的 AssetBundle 默认是“注册即加载”，但是否真输出，取决于它是否被当前视图或其依赖链显式调用。关键不在 Bundle 本身，而在注册时机和位置。
- 在控制器 action 里用
Yii::$app->view->registerAssetBundle(MyAsset::class)—— 仅对该 action 渲染的视图生效 - 在具体视图文件（如
views/post/view.php）顶部用$this->registerAssetBundle(MyAsset::class)—— 最精准，只影响这个视图 - 别在
AppAsset的depends里硬加业务 Bundle，否则它会随首页一起加载 - 如果用了
yii\web\AssetManager::bundles全局配置禁用某 Bundle，记得设'class' => null，不是false或空数组
publishOptions 和 forceCopy 什么情况下必须用？
当资源不在 Web 根目录下，又需要被浏览器直接请求时，Yii 会把文件“发布”到 web/assets/xxx/ 下。默认使用符号链接（Linux/macOS）或复制（Windows），但有些环境不支持链接，或你改了源文件想立刻生效——这时才需要干预。
- 部署在 Windows 共享主机或容器里，发现 CSS 404？加
'publishOptions' => ['forceCopy' => true] - 本地开发用 Docker，宿主机改了
resources/css/app.css，但页面还是旧样式？同样加forceCopy，避免链接缓存问题 -
forceCopy会拖慢首次访问速度，上线后应移除；生产环境更推荐用asset/compress命令预发布 - 不要给所有 Bundle 都配
publishOptions，只针对实际出问题的那几个
JS 文件里用 jQuery 报 “$ is not defined” 怎么办？
这不是 jQuery 没加载，而是加载顺序错了。Yii 的依赖声明（depends）控制的是 `<script>` 标签的输出顺序，但 JS 执行依赖的是 DOM 就绪时机和全局变量就绪时机。</script>
立即学习“前端免费学习笔记（深入）”；
- 确保你的 Bundle 的
depends包含yii\web\JqueryAsset::class，而不是只写yii\web\YiiAsset::class - 别在
js/目录里放内联脚本或未包装的$(function(){...})—— 放到js/app.js并在jsOptions['position']设为View::POS_READY - 如果用了
async或defer（通过jsOptions），会破坏依赖顺序，禁用它们 - 第三方库（如 Bootstrap）的 JS 如果依赖 jQuery，它的 Bundle 必须在
JqueryAsset之后注册，不能靠自己声明depends就完事——检查最终 HTML 的 script 标签顺序
sourcePath 的路径类型混淆和 JS 依赖的执行时机错配，这两处多看一眼生成的 HTML 就能定位。 
