radio互斥失效90%因name属性字符串不匹配:大小写、空格、符号、转义符等任何差异均导致分组断裂,须用开发者工具核验渲染后name原始值,动态生成时尤需警惕拼接错误与undefined赋值。

radio互斥失效,90%是name属性没写对——不是逻辑问题,是字符串字面量不匹配。浏览器只做严格相等判断,不自动修正大小写、空格或符号。
检查name是否完全一致(区分大小写、空格、符号)
浏览器对name值执行纯字符串比对,任何差异都会导致分组断裂:
-
name="theme"和name="Theme"→ 两组,可同时选中 -
name="user-type"和name="user_type"→ 两组 -
name="plan"和name="plan "(末尾空格)→ 两组 -
name="profile[gender]"和name="user.gender"→ 两组,即使语义相同
用开发者工具逐个点开每个<input type="radio">,直接看 Elements 面板里渲染出的name原始值,别信模板变量名或注释。
动态生成时name容易被漏设或拼错
JS 插入、Vue v-for 或 React map 渲染时,name极易因变量拼接失误而失配:
立即学习“前端免费学习笔记(深入)”;
- 写成
name={`option-${id} `}(尾部空格)→ 实际值带空格,分组崩了 - Vue 中绑定
:name="item.groupName",但某条数据里groupName是undefined→ 渲染出name="undefined",和其它项不一致 - 复制旧节点再修改
id和value,却忘了设el.name = "xxx"→ 新节点无name,变成“孤儿单选框”
建议用 document.querySelectorAll('input[type="radio"][name="xxx"]') 检查当前页面中该组实际有多少个成员,比肉眼数更可靠。
表单提交和 JS 获取都依赖name分组正确
name不仅是前端互斥依据,更是后端接收数据的唯一键名:
- 没选任何 radio 时,整个
name键不会出现在 FormData 或表单提交数据中(不像 checkbox 可能传空) - JS 获取选中值必须写
document.querySelector('input[name="xxx"]:checked')?.value,如果返回null,优先怀疑name不匹配,而不是 JS 逻辑错 - 后端收到多个同名参数(如
status=active&status=inactive),说明前端至少有两个不同name值被误认为同一组,或有非 radio 元素干扰了 name 命名空间
真正麻烦的不是“怎么写”,而是“怎么确认它真的写对了”——哪怕只多一个空格,浏览器就当它是另一个世界。



















