ctrl+shift+h（win/linux）或cmd+shift+h（macos）是vscode全局替换的正确入口，非ctrl+h；需确保面板右上角为工作区模式、启用.*正则、排除无关目录、手动保存变更。
VSCode 的全局替换不是靠一个快捷键“一键搞定”，而是分场景触发不同面板，用错快捷键就卡在当前文件里不动——Ctrl+Shift+H（Win/Linux）或 Cmd+Shift+H（macOS）才是真·全局替换入口，别再误用 Ctrl+H。
为什么 Ctrl+Shift+H 没反应？先看右上角图标状态
按下 Ctrl+Shift+H 后如果只搜了当前文件，大概率是面板右上角显示灰色“文档”图标，说明它没切到工作区模式。这不是崩溃，是状态残留。
- 手动点右上角 ⋯ → 勾选「在文件中查找」，比重按快捷键更可靠
- Mac 用户注意：
Cmd+Alt+F会被系统快捷键拦截，必须用Cmd+Option+F（Option 键即 Alt 键） - 右下角显示 Read-only 时，替换按钮会灰掉，得解除只读或用管理员权限重启 VSCode
限定文件范围必须手动填，不能靠默认
不填“包含文件”，Ctrl+Shift+H 默认扫整个工作区，包括 node_modules、dist 这类目录，既慢又危险。
- 只改 TypeScript 文件？在「files to include」里填
**/*.ts或src/**/*.ts - 只改 CSS？填
**/*.css；想排除旧样式文件，就在「files to exclude」里加*/legacy.css - 想精确到某几个目录？用 glob 模式，比如
{components,pages}/**/*.ts - 点「files to include」旁的 … 图标 →「Add pattern」，比手敲少出错
正则替换时 $1 生效的前提很具体
Ctrl+Shift+H 里的正则不是写了括号就能用 $1，漏一步就静默失败。
- 必须点亮
.*图标启用正则，否则(w+)当普通文本处理 -
.匹配字面点号，\才匹配字面反斜杠，搜索框里不能写单个 - 替换字段中引用捕获组只能用
$1，写就当普通字符输出 - 要字面输出
$abc，得写成$$abc； -
(?:)是非捕获组，不占编号，别指望它生成$1
Replace All 不等于“全部写入磁盘”
VSCode 的「全部替换」只改内存中的内容，不会自动保存。哪怕你看到所有文件都高亮变更了，不手动保存就是白干。
- 执行完
Replace All后，务必按Ctrl+Shift+S（Win/Linux）或Cmd+Shift+S（macOS）批量保存 - 大项目首次搜索有 1–2 秒延迟，右下角显示「搜索中…」时别急着重输关键词
- 预览列表里的每个匹配项都得扫一眼——尤其是正则替换后，
$1是否真捕获到了想要的内容 - 复杂重构前先
git commit，替换后用git diff快速核对，比肉眼检查靠谱
