AssetMapper 通过服务端映射实现客户端零构建，浏览器原生支持 importmap 即可运行。它自动解析 import 语句、下载 NPM 包或定位本地资源、生成哈希路径并注入 importmap，无需 npm、webpack 或 bundle；开发即改即用，生产仅需 symfony assets:install。
因为 AssetMapper 不走传统构建流程，它让浏览器直接加载 ES 模块——所有依赖解析、路径映射、版本控制都由 PHP 在服务端完成，浏览器只需原生支持 import 语句即可运行。
核心机制：服务端映射，客户端零构建
AssetMapper 把 JS/CSS 当作“PHP 可管理的资源”来处理。它不调用 npm install、不启动 webpack 或 vite、也不生成 bundle 文件。而是：
- 扫描
import 'lodash'或import './utils.js'等语句 - 自动下载对应 NPM 包（如 lodash@4.17.21）或定位本地 assets 文件
- 将资源复制到
public/assets/下，并生成带哈希的路径（如lodash@4.17.21/dist/lodash.min.js） - 在 HTML 中注入
<script type="importmap"></script>，把模块名映射为实际 URL
浏览器原生支持是关键前提
现代 Chrome、Firefox、Edge、Safari（2022 年后版本）均已支持 importmap 和顶层 await。这意味着：
-
import 'chart.js'不再需要打包，浏览器收到映射后直接发起 HTTP 请求加载 - 没有构建步骤，开发时改完 JS 文件刷新即生效
- 生产环境也无需 Node.js —— Symfony 的
assets:install命令就能完成全部资源部署
它不替代 Node.js，而是绕过它的前端角色
Node.js 在传统前端流程中承担三类任务：包管理（npm）、构建（webpack/vite）、本地服务（dev server）。AssetMapper 只接管了前两项的等效能力：
- 包管理 → 由
importmap.php声明 + Symfony 自动下载实现 - 构建 → 完全跳过；模块按需加载，无合并、无转译（除非你显式配置 Babel 插件）
- 本地服务 → 仍可用
symfony server:start，但不再依赖 Node.js 提供 HMR 或 proxy
CDN 回退与本地优先策略进一步降低耦合
你可以在 importmap:configure 中设置 CDN 地址，比如：
importmap:configure --cdn=https://cdn.jsdelivr.net/npm/
这样当本地没找到 moment 时，会自动回退到 CDN 加载；而一旦你把它写进 importmap.php，Symfony 就会把它下载到本地并锁定版本。整个过程不触发任何 Node.js 运行时。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
