Auto Rename Tag需安装Jun Han插件、设语言模式为HTML/Vue/JSX、光标置于标签名内编辑三者缺一不可；内置功能有限，仅该扩展稳定支持复杂场景。
Auto Rename Tag 不是开箱即用的功能，必须安装插件 + 正确配置语言模式 + 满足触发条件，三者缺一不可。
必须安装 Jun Han 的 Auto Rename Tag 插件
VSCode 1.86+ 虽然内置了基础 HTML 标签重命名能力，但仅限简单结构、不支持 JSX/Vue 模板块、也不处理自闭合标签。真正稳定可用的仍是 Jun Han 开发的 Auto Rename Tag 扩展。
- 在扩展面板（
Ctrl+Shift+X）搜索Auto Rename Tag，认准作者是Jun Han - 安装后务必点击“重新加载”或重启 VSCode，否则插件不会激活
- 检查设置里
auto-rename-tag.enable是否为true（默认开启，但工作区设置可能覆盖）
语言模式必须是 html / vue / jsx 等有效类型
插件只在明确识别为标记语言的上下文中运行。光标停在 <div> 上却没反应？大概率是右下角状态栏显示的是 <code>Plain Text 或 JavaScript。
- 点击右下角语言标识，手动选
HTML（.html文件）或Vue（.vue文件） - 对无后缀临时文件或
.js里写的模板字符串，插件完全不工作 - Vue 单文件组件中，只有
<template>区域生效；<script>和<style>里无效 - JSX 文件需确保语言模式是
JavaScript React或TypeScript React，不是普通JavaScript
触发重命名的光标位置和编辑方式很关键
不是随便点一下就能改——它只响应「光标落在开始/结束标签的标签名内部」时的输入操作。
- ✅ 正确：光标在
<div>的div两个字符之间（比如<|div>或<d|iv>），然后直接打字替换 - ❌ 无效：光标在
<div class="foo">的class上、尖括号里、空格中、或换行符后 - 不支持通过
F2重命名（那是编辑器原生 rename 功能，对标签无效） - 若自动不触发，可用命令面板（
Ctrl+Shift+P）运行Auto Rename Tag: Rename Tag手动强制同步
容易被忽略的干扰项和兼容性限制
很多“开了但没用”的情况，其实卡在了边缘条件上。
- 多个标签类插件共存（如
Auto Close Tag、Prettier）可能劫持编辑事件，建议临时禁用测试 - Vue 模板中含
v-if、v-for或未转义的{、<（如{{ item < 0 }}）会破坏插件对结构的解析 - 文件过大（>500 行）或嵌套过深时，VSCode 1.85+ 会主动降级该功能，可尝试关闭
html.suggest.html5减轻负担 -
class、id、属性值、指令（如v-model）永远不会被联动修改——它只管标签名本身
最常出问题的地方不在插件本身，而在语言模式识别和光标落点。哪怕配置全对，光标停错一个字符，整个功能就静默失效。调试时先盯住右下角和光标位置，比反复翻 settings.json 更快。
