asset('css/app.css') 加载失败是因为路径必须严格对应 public/ 目录下的真实文件位置，如文件实际在 public/build/app.css，则应写 asset('build/app.css')；asset() 仅拼接路径，不自动查找或支持 glob。
直接用 asset() 函数，但必须确保路径相对于 public/ 目录，且资源文件真实存在——否则页面只显示 HTML 结构，控制台报 404。
为什么 asset('css/app.css') 加载失败？
常见错误是路径写错或文件没放对位置。Symfony 的 asset() 不会自动查找、不支持 glob 匹配、不递归扫描目录。它只是拼接：/ + 参数值，并加前缀（如 /build 或 /），最终指向 public/ 下的物理路径。
-
asset('css/app.css')→ 请求public/css/app.css，不是src/css/app.css或templates/css/app.css - 如果用了 Webpack Encore，默认输出到
public/build/app.css，那就要写asset('build/app.css') - 如果用了 AssetMapper，默认把 JS/CSS 放在
assets/下，但 CSS 仍需手动复制或映射到public/assets/才能被asset()访问（AssetMapper 本身不接管asset()）
如何确认 asset() 输出的 URL 是否正确？
在 Twig 模板里临时加一行调试：
{{ asset('css/app.css') }}
查看浏览器源码，看它生成的是不是你预期的 URL（比如 /css/app.css 还是 /build/app.css）。再手动在浏览器地址栏访问这个 URL，确认是否返回 CSS 内容而非 404。
立即学习“前端免费学习笔记（深入）”；
- 如果返回 404：检查文件是否真在
public/css/app.css - 如果返回空白或乱码：可能是 MIME 类型不对，Nginx/Apache 没配好
.css的Content-Type - 如果路径带了
/build/但你没跑 Encore 构建：删掉setPublicPath('/build')或改回'/'
Webpack Encore 和 AssetMapper 对 asset() 的影响
asset() 本身不感知构建工具，它只读 framework.assets.base_urls 和 framework.assets.json_manifest_path 配置。真正影响输出路径的是你是否启用了版本化、是否配置了 manifest 文件。
- Encore 场景：必须在
webpack.config.js中调用Encore.setPublicPath('/build')，并确保config/packages/framework.yaml里没覆盖assets.base_urls - AssetMapper 场景：
asset()仍然有效，但它和 importmap 是两套机制；AssetMapper 管 JS 模块加载，asset()管传统静态链接，CSS 若想走 importmap 需用import 'app.css'（需额外插件支持，原生不支持 CSS import） - 混用风险：同时装
symfony/webpack-encore-bundle和symfony/asset-mapper容易导致asset()指向错误路径，建议二选一
最常被忽略的一点：修改了 public/ 下的文件后，别忘了清浏览器缓存——特别是 CSS，304 响应可能让你误以为路径对了，其实加载的是旧缓存。
