ctrl+shift+h（win/linux）或cmd+shift+h（macos）是vscode全局替换唯一标准入口；ctrl+shift+f仅打开全局搜索面板且替换框默认隐藏，必须手动点击右侧箭头或按ctrl+alt+enter展开替换区域才能执行替换。
Ctrl+Shift+H（Windows/Linux）或 Cmd+Shift+H（macOS）是 VSCode 全局替换的唯一标准入口，不是 Ctrl+Shift+F ——后者只负责搜索，不带替换能力。
为什么 Ctrl+Shift+F 不能直接替换？
因为 Ctrl+Shift+F 打开的是「全局搜索面板」，它默认只显示匹配结果，替换框是隐藏的。你必须手动点击搜索框右侧的「展开替换」箭头（或按 Ctrl+Alt+Enter），才能激活替换功能。很多人卡在这一步，输完词就点「全部替换」，结果按钮灰掉——根本没触发替换态。
- 确认是否已点击箭头图标：它在搜索框最右边，图标是两个重叠文档 + 向右箭头
- macOS 用户注意：
Cmd+Alt+Enter中的Alt就是Option键，别误按成Cmd+Ctrl+Enter - 如果面板里没看到第二个输入框，说明还没进入替换模式，此时点「全部替换」无效
files to include 不填等于裸奔
默认情况下，Ctrl+Shift+H 会扫描整个工作区，包括 node_modules、dist、.git 等目录。一次误操作可能改掉 2000 行打包产物，Git diff 直接爆炸。
- 务必在搜索框下方的「files to include」栏填入限定模式，例如：
src/**/*.ts、**/*.js、packages/*/src/** - 点击旁边的
…图标选「Add pattern」，比手敲更防错 - 想排除某些路径？用「files to exclude」填
**/test/**或**/*.spec.ts - 正则启用后，
files to include仍只支持 glob 模式，不支持 JS 正则语法
正则替换时 $1 失效的三个常见原因
写好 import\s+(\w+)\s+from\s+['"](.+?)['"] 却发现 $1 和 $2 没被替换进去？大概率是下面某个环节断了。
-
.*按钮没点亮：必须点击搜索框左侧的 .* 图标启用正则，否则括号只是字面字符 - 用了
\1而不是$1：VSCode 只认$n格式，\1会被当普通文本原样输出 - 捕获组编号错位：非捕获组
(?:...)不占编号，((?:foo)(bar))中$1是整个匹配，$2才是bar - 要字面输出
$abc，得写成$$abc，否则会被解析为变量引用
「全部替换」前漏掉 Find All 就是埋雷
VSCode 的「全部替换」按钮不会重新扫描文件，它只作用于当前已高亮的匹配项列表。如果你没点过「查找全部」（或回车执行搜索），面板里空空如也，那「全部替换」实际什么都不会做——还给你弹个「0 个替换」的提示，让你误以为安全。
- 每次打开
Ctrl+Shift+H后，先输完搜索内容，再按Enter或点「查找全部」按钮 - 确认左侧文件树里出现匹配项，且右侧预览窗口能看到上下文，再动替换
- 对关键重构（比如改 API 调用签名），建议先勾选「全词匹配」+「区分大小写」，避免
user把username也干掉
真正危险的不是快捷键记错，而是把「全局替换」当成无状态操作——它依赖你手动确认的匹配快照。一旦跳过 Find All，或放任默认路径扫描，后面所有替换都建立在错误前提上。
