symfony assetmapper 是 symfony 6.3 引入的轻量级前端资源管理方案，不依赖 node.js、无需构建步骤，通过 importmap 实现 es 模块原生加载，支持本地文件、npm 包及 cdn 回退，三步即可启用，并天然适配生产环境静态化、哈希版本与 cdn 部署。
Symfony AssetMapper 是 Symfony 6.3 引入的轻量级前端资源管理方案，不依赖 Node.js、无需构建步骤，适合中小型项目或希望简化前端流程的团队。它不是替代 Webpack Encore，而是提供另一条更直接的路径：把 JS/CSS 当作“PHP 包”来管理——自动下载、版本锁定、按需加载、零配置上线。
核心机制：资源即包，映射即加载
AssetMapper 把 node_modules 中的前端库（如 jQuery、Chart.js）或本地 assets/ 下的文件，视为可声明、可导入、可映射的“资产包”。它通过 importmap.php（或自动推导）生成浏览器可执行的 <script type="importmap"></script>，让现代浏览器原生支持 ES 模块导入，无需打包。
- 所有资源路径由 Symfony 自动解析并映射到
/assets/下的公开位置（如public/assets/vendor/jquery@3.7.1/dist/jquery.min.js） - 导入语句（如
import 'jquery'）在运行时被重写为对应 URL，不经过构建，开发即所见 - 支持本地文件（
import './my-component.js'）、NPM 包（import 'lodash'）、CDN 回退（通过importmap:configure设置）
三步启用：安装 → 声明 → 使用
无需 webpack.config.js，也不用 npm run build：
-
安装：运行
composer require symfony/asset-mapper（已内置在 Symfony 6.3+ 新项目中） -
声明资源：在
assets/app.js中直接写 ES import（例如import $ from 'jquery'; window.$ = $;），或在importmap.php手动注册别名与版本（推荐用于控制 CDN 或私有源） -
模板中启用：在 base 模板里放
{{ importmap('app') }}，它会自动注入<script type="importmap"></script>和入口脚本标签
解决常见问题：jQuery 全局变量、404、顺序依赖
报错 $ is not defined 不是 AssetMapper 本身的问题，而是模块执行顺序或作用域未暴露：
- 确保
import 'jquery'出现在使用$的脚本之前（ES 模块顺序严格） - 若需全局
$，在app.js顶部显式挂载：import jquery from 'jquery'; window.jQuery = window.$ = jquery; - 避免在
importmap.php中漏配依赖；AssetMapper 不自动解析require()或 CommonJS，只认标准import - 首次运行后执行
php bin/console asset-map:compile确保映射文件生成（开发环境通常自动触发）
生产部署：静态化 + 版本哈希 + CDN 支持
AssetMapper 天然适配 Symfony 资产管理生态：
- 运行
php bin/console asset-map:compile --production，所有资源被复制进public/assets/，文件名自动添加内容哈希（如jquery-8a2f3e4d.js），彻底规避缓存问题 - 配合
UrlPackage或自定义AssetMapper::getPublicPath()，可将public/assets映射到 CDN 域名（如https://cdn.example.com/assets） - 不生成 bundle 文件，但支持
import('./lazy.js')动态导入，实现天然代码分割
