VSCode需安装tonybaloney.vscode-surround插件并手动配置keybindings.json才能实现一键包裹选中文本为if-else结构，且依赖语言服务正确解析代码合法性。
VSCode 没有开箱即用的「一键包裹进 if-else」快捷键，必须靠插件 + 手动配置才能实现。原生功能里 Wrap with Abbreviation 只支持 Emmet 语法（如 if 会生成 if() {}，但不处理选中文本），且无法直接生成带 else 的完整结构。
装对插件：认准 tonybaloney.vscode-surround
别搜“Surround”就随便装——很多同名插件根本不支持 if/else 包裹。必须在扩展面板（Ctrl+Shift+X）中搜索 vscode-surround，确认作者是 tonybaloney、安装量超 50 万、描述含 “surround with if, for, try/catch”。装完右键选中代码，菜单里出现 Surround With 选项才算生效。
- 装错插件（比如
shanoor.vscode-sql-snippets或bradlc.vscode-todo-plus）会导致右键无此菜单，也配不出快捷键 - 插件启用后无需重启，但若右键没反应，检查是否被其他插件禁用或冲突（如某些语言服务器插件会拦截上下文菜单）
- 它默认只支持 JavaScript/TypeScript/Python/HTML 等主流语言；对 Vue 的
<script setup>或 JSX 内联表达式，需确保语言模式识别正确（状态栏显示vue或javascriptreact）
手动配快捷键：keybindings.json 里加 surround.with 命令
这个插件不带默认快捷键，必须进 keybindings.json 手动写。按 Ctrl+Shift+P → 输入 Preferences: Open Keyboard Shortcuts (JSON) → 添加如下条目：
[
{
"key": "ctrl+alt+i",
"command": "surround.with",
"when": "editorTextFocus && editorHasSelection",
"args": {
"language": "javascript",
"surrounding": "if (true) {\n\t$1\n} else {\n\t$2\n}"
}
}
]
-
when条件必须写全：editorTextFocus && editorHasSelection，否则光标没选中时也会触发，报错No selection to surround -
args.language要和当前文件语言 ID 一致（javascript、typescript、python），不匹配时命令静默失败 -
$1和$2是占位符，分别对应 if 块和 else 块内的光标位置；想让 else 块默认为空，把$2换成空字符串即可 - Windows 上
ctrl+alt+i容易和输入法冲突，可改用ctrl+shift+i，但需避开已占用的快捷键（如调试面板）
选区必须有效：括号/缩进/语言服务三重校验
即使插件和快捷键都配好了，仍可能失败——常见原因是 VSCode 认为当前选区“不可包裹”。这不是 bug，而是插件依赖编辑器的语言服务判断语义合法性。
- 选中内容不能跨函数或跨 class 边界（比如选中了
if块里一部分 + 外面一行，surround.with会拒绝执行） - Python 文件里若
editor.foldingStrategy设为indentation，插件可能无法识别逻辑块边界，建议保持默认auto - JSX 中选中
{items.map(...)}这种表达式时，必须确保光标在合法 JSX 元素内，且 Babel/ESLint 插件正常运行；否则语言服务返回空解析树，插件无从下手 - 最稳的兜底方式：先用
Ctrl+Shift+P→Select Bracket Contents精确选中花括号内内容，再触发包裹命令
嵌套 if-else 时注意缩进与光标落点
生成的 if (true) { ... } else { ... } 默认使用 4 空格缩进，但如果你的项目用 tab 或 2 空格，生成后要立刻调整——否则 ESLint/Prettier 会报错。
- 生成后光标停在
$1占位符处，此时按Enter换行会破坏缩进结构；应先删掉占位符再输入逻辑，或用Tab/Shift+Tab手动调 - 连续包裹（比如先包 if，再把整个 if-else 包进另一个 if）时，外层包裹会把内层整个块当作文本插入，可能导致缩进错乱；建议逐层包裹后立刻格式化（
Shift+Alt+F） - 不要指望它自动补全条件表达式——
if (true)是硬编码模板，你得手动改成if (user.role === 'admin')，插件不分析变量作用域
真正卡住人的地方不是配不配得出来，而是语言服务是否把当前代码当作可解析的合法结构。哪怕只少一个分号、多一个逗号，或者 JSX 里写了未闭合标签，surround.with 都可能静默失效——它不会报错，只是不执行。所以出问题时，先看右下角语言模式，再看 ESLint 是否飘红，最后再查快捷键配置。
