VS Code 搜索替换怎么限制在当前选中范围

在 VS Code 里只替换当前选中的一段文字，关键不是先按“替换全部”，而是先保留选区，再打开编辑器的 Find and Replace，最后打开 Find in Selection。这个开关激活后，查找和替换只作用于当前文件的高亮选区，选区外的同名文本不会被一起修改。

操作顺序是：选中文本 → 按 Ctrl+H → 填写 Find/Replace → 点击 Find in Selection 或按 Alt+L → Replace All → 检查选区外内容。

官方地址：https://code.visualstudio.com/docs/editing/codebasics

步骤一：先选中真正需要替换的范围

打开目标文件，把鼠标放在需要处理的第一行，拖到最后一行；也可以按住 Shift 配合方向键扩展选区。建议故意保留一处选区外的相同文本，例如把配置片段中的两行 timeout 选中，而把文件顶部的注释行留在选区外。这样最后能明确判断范围是否生效。

这里不要先按 Ctrl+F 再凭匹配数猜范围，因为普通查找默认针对当前文件。先让编辑器出现清晰的高亮选区，下一步的 Find in Selection 才有明确边界。

步骤二：打开 Find and Replace 并填写两个字段

保持光标仍在编辑器中，按 Ctrl+H。如果使用 macOS，则按 ⌘⌥F。在上方控件的 Find 输入框填写旧文本，例如 timeout；在 Replace 输入框填写新文本，例如 requestTimeout。

此时先不要点击 Replace All。控件会立即显示匹配标记，但这个阶段仍可能是整个文件的匹配结果。用眼睛确认选区还在，且 Find 字段里的文本没有多余空格；大小写、整词匹配和正则开关也要保持在符合本次任务的状态。

步骤三：打开 Find in Selection 范围开关

在 Find/Replace 控件右侧找到 Find in Selection 图标并点击。Windows/Linux 也可以直接按 Alt+L；VS Code 官方文档将它定义为把查找操作限制到当前选中文本的入口。启用后，图标会呈激活状态，编辑器中的匹配高亮应当只落在选区内。

如果你看不到这个图标，先把查找控件展开到包含高级选项的状态，再检查选区是否还存在。选区丢失时不要继续替换，先关闭控件、重新选择范围，再按 Ctrl+H 重来。

步骤四：Replace All 后做一次范围验收

确认 Find in Selection 已激活、匹配计数符合预期后，点击 Replace All。替换完成后，先看选区内的旧文本是否全部变为新文本，再点击选区外原本保留的同名文本，确认它没有变化。最后按 Ctrl+S 保存；如果文件标签页的未保存圆点消失，说明这次编辑已写入磁盘。

常见问题

Find in Selection 和普通 Ctrl+F 有什么区别？

普通 Ctrl+F 针对当前文件查找；Find in Selection 是范围开关，让查找、替换只落在已有选区。

能不能让 VS Code 默认只查多行选区？

可以在设置中搜索 editor.find.autoFindInSelection，设为 multiline 可让多行选区自动采用范围查找；需要每次都限制时可设为 always。

单行选区替换后仍然改多处怎么办？

先撤销，确认选区没有丢失，再检查 Find in Selection 图标是否处于激活状态。不要只根据高亮颜色判断，匹配计数也必须落在预期范围。