<script type="importmap"> 是 HTML 原生支持的声明式模块映射配置，用于将裸模块名（如 "react"）映射到实际 URL，解决浏览器无法解析 import React from "react" 等裸导入的问题；它必须置于 <head> 中、所有 type="module" 脚本之前，内容为合法 JSON，仅支持 imports 字段，且依赖现代浏览器支持（Chrome 89+、Firefox 109+、Safari 16.4+ 等）。
什么是 script type="importmap，它能解决什么问题
裸模块（bare import）指像 import React from "react" 这样不带协议、不带扩展名、也不以 ./ 或 / 开头的导入路径。浏览器原生不支持直接解析这种写法——会报 Failed to resolve module specifier "react" 错误。script type="importmap" 就是为了解决这个问题：它在 HTML 中声明一个 JSON 格式的映射表，把裸模块名“重定向”到真实可加载的 URL（比如 CDN 地址）。
怎么写一个合法的 importmap 块
必须放在 <head> 中，且只能有一个；内容是标准 JSON，不能有注释、尾逗号或变量插值；imports 是唯一必需字段，键是裸模块名，值是绝对 URL 或相对 URL（相对于当前 HTML 页面）。
<script type="importmap">
{
"imports": {
"react": "https://esm.sh/react@18.2.0",
"react-dom": "https://esm.sh/react-dom@18.2.0",
"lodash": "https://cdn.skypack.dev/lodash@4.17.21"
}
}</script>
- URL 必须是 HTTPS（本地开发可用
http://localhost），HTTP 协议会被浏览器拒绝 - 版本号建议锁定（如
@18.2.0），避免 CDN 缓存或上游变更导致行为突变 - 不能用
./node_modules/...这类路径——importmap不读取本地文件系统 - 如果映射目标是 ESM 兼容入口（如
https://esm.sh/或https://cdn.skypack.dev/返回的模块），才能被import正常执行
为什么 import 语句仍报错？常见兼容性陷阱
即使 importmap 写对了，import 也可能失败。核心原因是：支持 importmap 的浏览器有限，且需配合模块脚本使用。
- Chrome 89+、Edge 89+、Firefox 109+、Safari 16.4+ 支持；旧版 Safari（type="importmap"，会静默忽略
-
<script>标签必须带type="module"，否则import语法不生效，且不会触发importmap解析 - CDN 返回的内容必须是有效的 ES 模块（
Content-Type: application/javascript+ 导出声明），例如https://unpkg.com/react@18.2.0/umd/react.development.js是 UMD，不能直接import - 映射目标若返回重定向（302），部分浏览器（如旧版 Chrome）可能丢弃
importmap上下文，导致后续导入失败
如何验证 importmap 是否生效
最直接的方式是在 DevTools 控制台运行 console.log(importMap)（注意不是全局变量，而是通过 document.querySelector('script[type="importmap"]') 解析后查看）；更可靠的是检查网络请求和错误信息。
立即学习“前端免费学习笔记（深入）”；
- 打开 Network 面板，过滤 JS 请求，确认浏览器实际发出的请求 URL 是否与
importmap中配置的一致 - 若控制台报
TypeError: Failed to resolve module specifier "xxx"，先检查该模块名是否拼写一致（大小写敏感）、是否漏写type="module" - 用
curl -I https://esm.sh/react@18.2.0确认 CDN 返回状态码是 200，且Content-Type包含javascript - 避免在同一个页面混用多个
importmap：第二个会被忽略，且无任何警告
裸模块映射本身很简单，但真正卡住人的往往是 CDN 选型、浏览器支持边界和模块格式兼容性——这些地方没对齐，importmap 就只是个 JSON 字符串。
