Ctrl+H仅在当前文件查找替换，Ctrl+Shift+H才是工作区全局替换；需手动设置文件过滤、启用大小写/全字匹配、验证输入无隐藏字符，并替换前逐项确认上下文。
Ctrl+H 和 Ctrl+Shift+H 有什么区别
直接按 Ctrl+H 是当前文件内查找替换，而 Ctrl+Shift+H 才是真正意义上的全局替换（工作区范围）。很多人误以为 Ctrl+H 能跨文件操作，结果只改了当前文件，等上线才发现漏改——这是最常踩的坑。
触发 Ctrl+Shift+H 后，VSCode 会打开「搜索」面板，默认聚焦在「查找」输入框。它会自动读取当前打开的文件夹（即工作区根目录），但不会递归扫描所有子目录，除非你手动勾选「包括子文件夹」或确认路径过滤器没意外排除目标目录。
如何精准限定替换范围避免误伤
全局替换最怕改错地方，比如把注释里的字符串、第三方库路径、甚至 JSON key 都一起替换了。必须主动控制范围：
- 在搜索面板右上角点击
?图标，设置「文件名包含」，例如填*.ts或src/**，避免扫到node_modules或dist - 勾选「仅限打开的编辑器」可临时缩小为已打开的标签页，适合快速验证替换逻辑
- 启用「匹配大小写」和「全字匹配」（
abc不会匹配abc123或myabc），这两个开关默认关闭，务必根据语义手动打开 - 如果要替换的是正则模式（比如补全 import 路径），记得点右侧
.*按钮开启正则模式，否则\或$1会被当普通字符处理
替换前必须做的三件事
别急着点「全部替换」。真实项目里，一次误操作可能引发编译失败或运行时异常：
- 先点「查找全部」，看左侧边栏列出的所有匹配项，人工扫一遍上下文是否合理——特别是靠近
if、return、import的位置 - 检查是否有未提交的本地修改：VSCode 全局替换不会跳过未保存文件，但如果某文件有 Git 冲突标记（如
<<<< HEAD），替换可能破坏冲突结构 - 确认搜索字符串里没有隐藏空格或不可见字符（比如从网页复制的代码常带
替换后编译报错？先查这几个地方
即使预览看起来都对，替换后仍可能出问题：
- 字符串拼接被截断：比如原代码是
url: '/api/' + id，你替换了'/api/'为'/v2/api/'，但漏看了后面还有个+，导致变成'/v2/api/' + id—— 语义没变，但若 id 是数字，加号可能被解释为数值相加 - ESLint 或 Prettier 自动格式化冲突：替换后代码缩进或分号缺失，保存时被自动改回旧风格，造成「明明替换了却没生效」的错觉
- Vue/JSX 中的插值表达式：比如
{{ item.name }}里替换了name，但没注意外层是v-bind:title="item.name"，属性绑定语法不识别双大括号，导致实际没更新
真正麻烦的不是替换动作本身，而是不同上下文对同一字符串的语义解读差异。多花十秒看一眼匹配行的前后两行代码，比事后翻 Git log 快得多。
