Surround插件支持一键为选中文本添加括号、引号等包围符号，提供命令面板、快捷键、右键菜单三种调用方式，并支持自定义模板及多行嵌套处理。
如果您在VSCode中需要为已选中的代码片段快速添加括号、引号、注释等包围符号，则Surround插件可直接实现一键包裹。以下是使用该插件完成包围操作的具体方法：
本文运行环境：MacBook Air，macOS Sequoia。
一、通过命令面板触发Surround
该方式适用于任意语言模式下的选区，不依赖快捷键记忆，操作路径清晰可控。
1、在编辑器中选中目标文本内容。
2、按下 Cmd + Shift + P（macOS）或 Ctrl + Shift + P（Windows/Linux）打开命令面板。
3、输入 Surround With 并回车确认。
4、从下拉列表中选择所需符号，例如 " "、( )、[ ]、{ } 或 < >。
二、使用快捷键快速调用
启用快捷键后可跳过命令面板步骤，显著提升高频包裹操作的效率。
1、确保Surround插件已启用且未被其他扩展覆盖快捷键。
2、选中待包围文本。
3、按下默认快捷键 Cmd + Shift + T（macOS）或 Ctrl + Shift + T（Windows/Linux）。
4、在弹出的内联输入框中键入符号名称缩写，例如 q 表示双引号，sq 表示单引号，p 表示圆括号。
三、通过右键菜单调用
该方式无需记忆快捷键或命令名称，适合临时使用或教学演示场景。
1、在编辑器中右键点击已选中文本区域。
2、在上下文菜单中定位并点击 Surround With... 选项。
3、在随后出现的符号选择面板中，用鼠标点击目标符号类型。
4、插件将自动在选区前后插入对应符号，并保持光标位于内部可编辑位置。
四、自定义包围模板
当内置符号无法满足需求时，可通过配置文件添加HTML标签、日志包裹、条件注释等结构化模板。
1、打开VSCode设置，搜索 surround.custom。
2、点击 Edit in settings.json 进入JSON配置界面。
3、在 "surround.custom" 对象内新增键值对，例如："log": ["console.log(‘", "’);"]。
4、保存后重启编辑器或重载窗口，新模板即可在命令面板和快捷键菜单中调用。
五、处理多行选区与嵌套包围
Surround支持跨行文本及已有包围结构的智能识别，避免重复嵌套或格式错乱。
1、按 Shift + Alt + ↓（macOS）或 Shift + Alt + ↓（Windows/Linux）进行多行选中。
2、执行任意一种Surround调用方式。
3、若选区已含外层符号，插件将自动检测并仅向最外层添加新符号，例如选中 "abc" 后选择 [ ]，结果为 ["abc"] 而非 [""abc""]。
