AssetMapper不能取代Webpack，它绕过构建直接映射ES模块路径；Webpack是完整打包器，负责依赖解析、转译、压缩等全流程，而AssetMapper仅声明包、下载资源、生成importmap，不运行任何打包逻辑。
AssetMapper 不能取代 Webpack，它压根不处理构建——它绕过了构建。
AssetMapper 根本不运行打包器
Webpack 是一个模块打包器：它读取 import、解析依赖、转译 TypeScript、压缩 JS、提取 CSS、生成哈希文件……整个过程需要 Node.js 和大量配置。AssetMapper 完全不干这事。它只做三件事：声明你要用什么包（比如 import 'chart.js'）、下载对应版本到 vendor/ 或 public/assets/、生成一个 <script type="importmap"> 告诉浏览器“chart.js 这个名字，实际加载的是 /assets/vendor/chart.js@4.4.3/dist/chart.umd.js”。浏览器原生支持 importmap，所以不用打包，也不需要 npm run build。
- 你写
import './my-modal.js'，AssetMapper 就把它映射成/assets/js/my-modal.js，路径直接透出 - 你写
import 'lodash'，它自动下载lodash@4.17.21并映射到本地/assets/vendor/lodash@4.17.21/lodash.min.js - 没有
webpack.config.js，没有 loader，没有 plugin，也没有node_modules目录残留
什么时候 importmap.php 会失效？
AssetMapper 的映射表默认由 importmap.php 自动生成，但这个文件不是“配置”，而是“快照”。一旦你手动改了它，下次运行 php bin/console importmap:install 或 php bin/console importmap:require 就会被覆盖。真正该改的是命令行操作本身：
- 加包别手写
importmap.php，用php bin/console importmap:require chart.js - 删包别删数组项，用
php bin/console importmap:remove chart.js - 本地文件要被识别，必须放在
assets/下且以./或../开头的相对路径导入，否则 AssetMapper 当作包名去 npm 查 -
import 'react'这种写法会失败——React 不支持 UMD，也没提供浏览器可用的 ESM 入口；AssetMapper 不做转译，只做路径映射
为什么 {{ asset('js/app.js') }} 在 AssetMapper 项目里可能 404？
因为 AssetMapper 默认不生成 public/build/ 下的任何文件，asset() 函数查的是 framework.assets.base_urls 和 json_manifest_path 配置。如果你没关掉 manifest 版本策略，Symfony 仍会尝试从 manifest.json 解析路径，而 AssetMapper 根本不生成那个文件。
立即学习“前端免费学习笔记（深入）”；
- 必须删掉或注释掉
config/packages/asset.yaml里的json_manifest_path行 - 确保
framework.assets.base_urls没指向错误子目录（比如['/myapp']却部署在根路径） - 本地文件如
assets/js/app.js会被复制到public/assets/js/app.js，所以{{ asset('js/app.js') }}实际输出/assets/js/app.js，不是/build/js/app.js - 如果硬要用
/build/路径，得手动在webpack.config.js里配好，但那就不是 AssetMapper 了
CDN 回退和生产部署的真实限制
AssetMapper 支持通过 importmap:configure 设置 CDN 回退，比如把 lodash 映射为 https://cdn.jsdelivr.net/npm/lodash@4.17.21/lodash.min.js，但它不会检查该 URL 是否真能访问，也不会在 CDN 失效时自动切回本地。更关键的是：CDN 资源必须是可跨域（CORS）且支持 ESM 加载的，而很多老牌 CDN（如 unpkg 默认）返回的是 CommonJS 或 IIFE，浏览器直接报 TypeError: Failed to resolve module specifier。
- 验证方式很简单：打开浏览器控制台，执行
import('https://cdn.example.com/pkg.js')，看是否成功 - 生产环境启用哈希需手动开启：
php bin/console importmap:compile --optimized，它会生成带哈希的文件并重写importmap.php，但不修改 HTML 中的<script type="importmap">内容——那部分得你自己缓存或用响应头控制 - 它不处理 CSS 文件的
@import或url()重写，所以import './style.css'只是加载样式表，里面引用的字体、图片路径仍按原始相对路径解析
AssetMapper 真正省掉的不是“Webpack 配置”，而是整个构建心智模型：你不再需要想“这个包要不要 external”、“CSS 怎么抽离”、“source map 怎么配”，它只回答一个问题——“这个 import，浏览器该从哪加载”。一旦你的需求超出“原生 ES 模块加载”，比如要跑 React JSX、要 Sass 编译、要代码分割，就得切回 Webpack Encore，或者另起一套 Vite 流程。
