surround插件需手动触发且依赖语言模式和选区：先确认右下角语言为js/ts/html等支持类型，再选中有效代码右键调用“surround with”或ctrl+shift+p搜该命令；快捷键需在keybindings.json中配置"surround.with"命令并限定editorhasselection条件。
Surround 插件装完没反应？先确认语言模式和触发方式
Surround 插件（vscode-surround）本身不接管快捷键，也不自动监听选区——它依赖你主动调用命令或右键菜单。如果你装完点右键没看到 Surround With，大概率是当前文件的语言模式未被识别为它支持的范围（如 JavaScript、TypeScript、Python、HTML 等），或者插件未正确激活。
检查步骤：
- 看右下角状态栏语言标识，不是
Plain Text或Unknown；如果是JavaScript却想包 JSX 标签，手动按Ctrl+Shift+P→ 输入Change Language Mode→ 选JavaScript React - 确保已选中一段有效代码（不能只选空格或换行符）
- 右键菜单里找
Surround With，不是Wrap With或其他类似名称；若没出现，按Ctrl+Shift+P直接搜Surround With命令
怎么用快捷键一键触发 Surround？别硬记，直接改 keybindings.json
Surround 插件默认不绑定快捷键，但你可以自己加一条。它提供的命令名是 surround.with，不是 editor.action.surround 或其他变体——拼错就无效。
操作路径：Ctrl+Shift+P → Preferences: Open Keyboard Shortcuts (JSON) → 在数组里加：
{
"key": "ctrl+alt+s",
"command": "surround.with",
"when": "editorTextFocus && editorHasSelection"
}
注意两个关键点：
-
when条件必须包含editorHasSelection，否则光标没选中时也会触发，弹出空模板 - 别和 Emmet 的
editor.emmet.action.wrapWithAbbreviation快捷键冲突（比如都设成Ctrl+Alt+W）
选中多行代码后，Surround 只包了第一行？这是设计行为，不是 bug
Surround 插件对多行选中的处理逻辑是：把每行当作独立片段，依次套用同一模板。例如你选中三行：
foo bar baz
再选 if 模板，结果会是：
if (true) {
foo
}
if (true) {
bar
}
if (true) {
baz
}
这不是错误，而是插件明确的逐行包裹策略。如果你要的是「一个 if 包裹全部三行」，得手动做两件事：
- 先把三行合并成连续文本块（删掉中间换行，或用
Ctrl+J连行） - 或者改用
Emmet: Wrap with Abbreviation+if>div缩写（需语言模式为 JSX/HTML）
自定义模板怎么写？别碰 JSON 语法错误，用 snippet 更稳
Surround 插件本身不支持用户自定义模板语法，它的预设项（if、try、for 等）是硬编码在插件里的。想加 useMemo 或 <suspense></suspense> 这类 React 特有结构，得绕道 user snippets + surround.with 命令组合。
推荐做法：在 javascriptreact.json 里加 snippet，再用 Surround 触发它：
"Wrap in useMemo": {
"prefix": "memo",
"body": ["useMemo(() => {", "\t$1", "}, [$2]);"],
"description": "Wrap selection in useMemo"
}
然后在命令面板里搜 Insert Snippet → 选 memo，就能把选中内容塞进 useMemo 里。注意 $1 是光标初始位置，$2 是依赖数组光标位——这个顺序容易反，一反就卡住编辑流。
