Import Maps · type=module · integrity · Safari · Chromium · 远程 Mac · 2026
2026 远程 Mac 前端发布验收：
Import Maps 与原生 ESM：Safari / Chromium 差异表与渐进增强三步清单
2026.04.16
前端 / 模块系统
约 8 分钟阅读
Import Maps 与 type=module 应可关闭而非唯一入口；仅跑 Linux Chromium 无头易漏 WebKit 对 map 顺序与 Worker 作用域。本文含对照表、渐进增强三步、integrity 与降级、Playwright 与预览参数。延伸阅读：Vite/Webpack 与 Safari 验证、CSP 与 Safari 验收；首页、资费、帮助、购买。
发布闸 · 真机 Safari + Chromium · map 与哈希同事务
00 常见翻车点（发布前扫一眼）
1）预发与生产 map 不一致，裸说明符在 Safari 爆红。2）integrity 与 CDN 内容轮换不同步，模块整批拒载。3）降级只删 map 未切 script 或 legacy，白屏；用户侧难自助恢复，常需运维回滚。
01 Safari 与 Chromium 差异对照表
两引擎均支持 map 与 type=module；差异在解析边界与排障信号。
| 主题 | Safari / WebKit | Chromium（Blink） |
|---|---|---|
| 模块解析与 map | importmap 须先于模块脚本；裸说明符靠 map；Worker 是否与主文档共享 map 勿假设。 |
规则相近；问题面板对缺失说明符提示更直。 |
| integrity | map 与 script 的 integrity 须与响应体一致；错缓存即硬失败。 |
同类；NetLog 可拆网络与 SRI。 |
| 动态 import | 失败看控制台与网络 MIME 是否被改写。 | 工具链更全；扩展可能改请求。 |
| 降级策略 | 关 map 后退回相对路径或 bundle；隐私窗口缓存叙事与主配置不同。 | 同理；无痕策略另有差异。 |
| 自动化与真机 | Playwright webkit 覆盖主路径；代理与证书用远程 Mac 真 Safari 补测。 |
chromium 加 Trace；与 WebKit 对照签字。 |
同事务发布
map、入口 HTML、静态资源与 integrity 同事务发布；灰度忌半新半旧。
02 渐进增强三步验收
- 基线：无 map 可启动（相对路径或 bundle）；裸说明符仅增强路径。
- 增强：同 URL、同构建号，清缓存后双浏览器主流程；Playwright
webkit+chromium断言无模块错误。 - 哈希与回滚：工单记 map 版、
integrity、CDN 键；失败回 legacy 或上一版 map，附控制台与 Trace。
03 本地预览与 Playwright 要点（可执行）
与 QA 同命令；预览保证 Content-Type 正确。
- □ Vite：
npx vite preview --host 0.0.0.0 --port 4173 --strictPort - □ 静态：
npx serve -s dist -l 4173 --cors，查.mjsMIME。 - □ Playwright：
npx playwright test --project=webkit --project=chromium，pageerror断言，留trace.zip。 - □ Safari：远程 Mac 开发菜单，网络里核对
importmap与首模块。 - □ Chromium：
chrome://net-export/可选，对齐 CDN 请求 ID。
04 可引用检查项（贴进工单）
- 构建号：SHA 或流水号与 map 同源发布。
- 哈希：带
integrity的资源在预发/生产各抽体校验。 - 截图：双引擎控制台零模块错误各一，附 UTC 时间。
05 FAQ
Worker 里能用和页面一样的裸说明符吗？
视注册方式而定；勿假设继承，Worker 内优先可解析 URL。
integrity 报错如何快速判因？
比对体与哈希，再查中间层改写与缓存键。
远程 Mac 在流程里站哪一格？
提供 WebKit 真 Safari，与 Chromium、CLI 同机对照，作模块签字环境。
给发布负责人的一句话
map、文件与 integrity 同事务；远程 Mac 绑 WebKit 与 Blink 于同一工单再灰度。
更多文章：博客列表。