VSCode需手动安装tonybaloney.vscode-surround插件并配置快捷键，支持if/for等代码包裹；须正确设置when条件、语言ID及自定义模板，且仅对有效选区和受支持语言生效。
VSCode 默认不带 Surround 插件，先确认你装的是哪个
VSCode 原生没有叫 “Surround” 的内置功能，所谓“Surround 插件”通常指社区轻量插件 bradlc.vscode-todo-plus 或更常见的 techer.open-in-browser ——但这些都不干包裹代码的事。真正能实现 if/for 包裹的，是 surround 插件（作者：formulahendry.code-runner 团队曾推荐，但当前维护版是 johnpapa.angular-essentials 里拆出的独立版）或更主流的 vscode-surround（ID：shanoor.vscode-sql-snippets 不相关，正确 ID 是 tonybaloney.vscode-surround）。
安装前请打开扩展面板（Ctrl+Shift+X），搜 vscode-surround，认准作者为 tonybaloney、安装量超 50 万、描述含 “surround with if, for, try/catch” 的那个。
装完不重启也行，但得确认它已启用——右键选中代码，菜单里出现 Surround With 选项，才算到位。
快捷键绑定必须手动加，且 when 条件要写对
这个插件不自带默认快捷键，必须进 keybindings.json 手动配。直接按 Ctrl+Shift+P → 输入 Preferences: Open Keyboard Shortcuts (JSON) → 添加如下条目：
{
"key": "ctrl+alt+w",
"command": "surround.with",
"when": "editorTextFocus && editorLangId == 'javascript' || editorLangId == 'typescript' || editorLangId == 'python'"
}
注意三点：
-
surround.with是该插件注册的唯一命令名，别写成surroundWith或editor.surround—— 那些都无效 -
when条件里语言 ID 必须准确：javascript不是js，typescript不是ts；Vue 单文件脚本需额外加editorLangId == 'vue' - 若你在 JSX 文件里想用，得把语言模式切到
JavaScript React（右下角点击切换），否则editorLangId是javascript但实际不生效
触发后菜单没 if/for？检查选区和语言上下文
按快捷键后弹出空白菜单或只有 quotes/parentheses，大概率不是插件问题，而是：
- 选中的内容不能是空行、纯注释、或跨多语言区块（比如在 Vue 的
<template></template>里选中一段 JS 表达式） - 当前文件类型未被插件支持：它默认只开
javascript、typescript、python、php；Go/Rust 等需进插件设置页手动开启 - 你选中了函数调用如
foo()，但它只提供if模板，不会自动推导成if (foo()) { }—— 它只包裹，不改逻辑
验证方法：新建一个 .js 文件，输入 console.log(1);，全选这行（不含换行符），再按快捷键，应该立刻看到 if、for、try/catch 等选项。
自定义 if 模板时，变量名和缩进容易错位
插件支持自定义模板，但配置位置不在 VSCode 设置里，而在插件自己的 settings.json 区域（Ctrl+, → 搜 surround → 找 Surround: Config）。点开编辑，加一段：
"if": {
"body": "if (${1:true}) {\n\t$SELECTION$\n}"
}
关键细节：
-
$SELECTION$是唯一占位符，必须原样保留，不能写成${0:$SELECTION$}或漏掉 -
\n\t中的制表符必须和你当前文件缩进设置一致（空格 or tab）；混用会导致包裹后缩进塌陷 - 模板名（如
"if"）必须小写，且不能和内置模板重名（内置已有if，所以这是覆盖；想新增叫ifTrue就得写新 key）
改完保存，快捷键重按一次才生效——别指望热更新。
最常被忽略的是：插件的模板不校验语法，if (x) console.log() 被包裹成 if (true) { if (x) console.log() } 后，可能因作用域或分号缺失直接报错。包裹只是文本操作，别让它替你思考逻辑。
