usemap属性必须带#且与map的name值逐字匹配，大小写、空格、连字符位置均需一致；map须与img同文档作用域；coords基于原始图片尺寸，缩放需手动重算；多个img可共用一个map，但usemap仅支持单值。
usemap 属性必须带 # 且与
浏览器只做字符串字面匹配，usemap="#product-map 必须对应 <map name="product-map">。漏掉 #、大小写不一致（如 Product-Map）、多空格或连字符位置错——全部静默失效，图片点击无反应，控制台也不报错。
实操建议：
-
name和usemap值统一用小写字母 + 短横线，例如nav-main，避免命名歧义 - 不要依赖 IDE 自动补全：有些编辑器会帮你加
#，但<map>的name不带#，务必手动核对 - 若用 JS 动态生成
<map>，确保插入 DOM 后再渲染<img>，或至少保证两者在同一个 document 上下文里
map 标签可以放在 img 前、后、甚至不同 div 里，但不能跨 iframe 或 fetch 注入
<map> 本身不渲染，也不要求紧邻 <img>。但它必须和 <img> 处于同一文档作用域——这是最容易被忽略的限制。
常见失效场景：
立即学习“前端免费学习笔记（深入）”；
- 把
<map name="x">放在外部 HTML 文件里，再用<iframe src="map.html">加载：不行，跨文档无法绑定 - 用
fetch拿到 map HTML 字符串后直接innerHTML = ...插入 body：如果<img>尚未解析完成，绑定可能失败 -
<map>被包裹在<template>或display: none容器中：不影响，只要它在 document.body（或 img 的祖先节点）里即可
area 的 coords 坐标基于原始图片尺寸，缩放后需重算
<area shape="rect" coords="10,20,100,80"> 这些值是按图片原始像素（比如 800×600）写的。如果 <img> 用 CSS 缩放到 400×300，热区就偏了——浏览器不会自动缩放 coords。
解决办法只有两个：
- 保持图片原始尺寸显示（最省事）
- 用 JS 监听图片加载完成，读取
naturalWidth/naturalHeight和offsetWidth/offsetHeight，按比例缩放所有coords值再重写<area>的属性
注意：shape="poly" 的坐标点数必须为偶数，shape="circle" 的第三个值是半径，不是直径。
多个 img 共享一个 map 是允许的，但 usemap 只能指向一个 map
一个 <map name="logo-nav"> 可被多个 <img usemap="#logo-nav"> 复用，只要它们尺寸一致、语义相同。但反过来不行：<img> 的 usemap 属性只接受单个值，不能写成 usemap="#map1 #map2"。
还要注意边界情况：
- 如果
<img>是<button>或<a>的子元素，usemap会被浏览器忽略（HTML 规范明确禁止） -
<area>的href和onclick同时存在时，记得在事件处理函数里return false，否则会先跳转再执行 JS - 移动端对
title属性支持弱，别依赖它做关键提示
实际调试时，最值得先检查的永远是：usemap 有没有 #、name 拼写是否完全一致、<map> 是否已存在于当前 document 中——这三个点卡住绝大多数问题。其他逻辑都是锦上添花。
