Ctrl+Shift+G 包裹失败主因是语言模式不匹配，仅在 html、javascriptreact、vue 等启用 Emmet 的模式下生效；缩写语法错误（如缺引号、空格中断）也会静默失效。
Ctrl+Shift+G 包裹失败，先看语言模式对不对
Emmet 的 Wrap with Abbreviation 不是“按了就包”，它只在 html、javascriptreact、vue、typescriptreact 等明确启用 Emmet 的语言模式下生效。你在 .js 文件里写 JSX，右下角显示的是 JavaScript，那 Ctrl+Shift+G 就不会响应——必须点右下角语言标识，手动切到 JavaScript React。
常见误判：以为后缀名决定行为，其实 VSCode 完全按当前语言模式（editorLangId）判断。哪怕你把 index.txt 里写了完整 HTML，只要没手动切语言模式，Emmet 就不启动。
- 检查方式：
Ctrl+Shift+P→ 输入Change Language Mode→ 看当前值 - Vue SFC 中，
<template></template>区域需语言模式为vue；<script></script>区域若含 JSX，得切javascriptreact - 语言模式错误时，快捷键静默失效，控制台无报错，容易误以为快捷键坏了
输入缩写后回车没反应？大概率语法写错了
Emmet 解析缩写不是字符串拼接，而是语法树构建。写错一个符号，它就放弃生成，不提示、不报错、只返回光标到原位置。
合法写法示例：div.my-class、span[data-id="123"]、ul>li*3；非法写法如 div class="x"（空格中断解析）、div#id .cls（混用且无括号）、input[type=text]（缺引号）都会被静默忽略。
- 属性必须用方括号：
input[type="text"]✅，input[type=text]❌ - 多类名写成连字符：
div.foo.bar→<div class="foo bar">，不是 <code>class="foo.bar" - JSX 中
input自动补为<input>，但input[type="text"]才带属性，只写input不会加/在末尾 - 真正要开的是：
Editor › Auto Closing Quotes和Editor › Auto Closing Brackets，设为always或languageDefined - 触发条件严格：必须先选中文本，再按
"、'、(、[、{—— 光标停在词边直接按，只会插入符号，不会包裹 -
`（反引号）支持包裹，$和不参与此机制；HTML 中 <code> 触发标签补全，不是包裹 - 快捷键配置示例：
{ "key": "ctrl+alt+w", "command": "surround.with", "when": "editorTextFocus && editorLangId == 'javascript' || editorLangId == 'typescript'" } - 如果菜单里只有 quotes/parentheses，说明当前选区被判定为“不可包裹”——比如选了空行、注释、或跨了
<script></script>和<template></template>边界 - Vue 单文件中想在
<script setup></script>里用，语言模式必须是vue，不是javascript；否则插件根本不响应
想用括号/引号自动包裹，别开 editor.autoSurround
VSCode 没有独立的 “Auto Surround” 功能开关。你想要的“选中 hello 后按 " 变成 "hello"”，靠的是 editor.autoClosingQuotes + 选中状态共同触发，和 editor.autoSurround 无关。
editor.autoSurround 是个冷门设置：它控制“输入右符号时是否向左匹配未闭合左符号并包裹”，默认 disabled，开启后反而容易跨行误包，绝大多数人不需要它。
需要 if/for 包裹？surround 插件命令名和 when 条件不能错
VSCode 原生不支持逻辑块包裹，tonybaloney.vscode-surround 是目前最稳定的方案，但它不自带快捷键，且命令绑定极易出错。
关键点在于：command 必须写 surround.with，when 条件中的语言 ID 必须精确匹配（javascript 不是 js），而且插件只在选区为有效代码片段时才列出 if、for 等模板。
真正容易被忽略的是：所有包裹行为都依赖语言上下文而非文件后缀，且多数失败不是功能缺失，而是语言模式、缩写语法、选区形态三者中某一项没对齐。调不通时，先看右下角语言标识，再看缩写有没有空格或引号缺失，最后确认是不是跨行选中——这三步覆盖 90% 的问题。
