Ctrl+Shift+F（Win/Linux）或Cmd+Shift+F（macOS）是唯一全局搜索入口，Ctrl+H/Cmd+Option+F仅作用于当前聚焦文件；误用前者会导致仅局部替换，且VSCode不自动跨文件，必须手动展开Replace标签、设定范围并保存。
Ctrl+Shift+F（Windows/Linux）或 Cmd+Shift+F（macOS）是唯一能打开全局搜索面板的快捷键；Ctrl+H 或 Cmd+Option+F 只作用于当前文件，不能跨文件。
为什么 Ctrl+H 没法跨文件替换
很多人误以为 Ctrl+H 是“全局替换入口”，其实它只是当前文件的「查找并替换」面板。VSCode 明确区分了作用域：Ctrl+H（Win/Linux）或 Cmd+Option+F（macOS）只对编辑器中**已打开且聚焦的单个文件**生效。如果光标在终端、调试控制台或设置页，连面板都不会弹出。
常见错误现象：
- 按了
Ctrl+H没反应 → 光标不在文本编辑区 - 替换了但其他 .ts/.css 文件没变 → 本来就没设计成跨文件功能
- Mac 用户输成
Cmd+Alt+F→ 键盘上 Alt 就是 Option，但 VSCode 文档统一写Cmd+Option+F，别被键帽误导
真正跨文件替换必须用 Ctrl+Shift+F
Ctrl+Shift+F（Win/Linux）或 Cmd+Shift+F（macOS）才是全局搜索的唯一入口。它不依赖当前打开哪些文件，而是扫描整个工作区（workspace）路径下的内容。
关键操作要点：
- 输入关键词后，**必须手动点击搜索面板下方的「Replace」标签**，或按
Alt+R（Win/Linux）/Option+R（macOS）展开替换框——不展开，就只有搜索，没有替换按钮 - 「全部替换」按钮（双箭头图标）只对当前已列出的匹配项生效；它不会动态刷新结果，所以改完范围后要重新触发搜索
- 替换前务必检查右下角状态栏：显示
TERMINAL或DEBUG CONSOLE时，快捷键完全失效
文件范围控制不靠直觉，得手动填对格式
VSCode 的文件筛选逻辑很“刚”：它不识别嵌套通配符（如 src/**/api/**），也不自动理解你“只想改 .ts”——所有限制都得显式写进「包含文件」或「排除文件」框里。
正确写法示例：
- 只扫 TypeScript 文件：
*.ts（不是.ts，少星号无效） - 限定 src 下所有 .ts：
src/**/*.ts（**表示任意层级子目录） - 排除 node_modules 和 dist：
!node_modules/**,!dist/**（注意英文感叹号 + 斜杠） - 多个类型一起扫：
*.js,*.ts,*.html（逗号分隔，空格会被忽略）
容易踩的坑：
-
search.exclude配置项会静默拦截——即使你写了src/api/**，只要它匹配了search.exclude里的**/api/**，照样跳过 - 想临时绕过排除规则？点搜索面板右上角
⋯→ 取消勾选「使用排除设置」 - 路径写错导致漏文件：比如把
components/**写成component/**，少个 s 就全军覆没
正则替换时 $1 和 \1 完全是两回事
启用 .* 按钮后，替换字段里只能用 $1、$2 引用捕获组；\1 是 PCRE/Python 风格，在 VSCode 里会被当普通文本处理。
典型翻车场景：
- 搜
console\.log\(["'](.+?)["']\)，想替换成debugger; // $1→ 正确 - 同样正则，却填
debugger; // \1→ 不报错，但输出字面量\1，白忙活 - 要字面输出
$abc，得写成$$abc；$&表示整个匹配内容，$$&才输出$加原文 - 非捕获组
(?:...)不占编号，别指望它生成$1；括号必须有编号才有效
还有一个隐蔽问题：. 按钮（跨行匹配）一旦点亮，. 就能匹配换行符，但大多数 HTML/JS 替换不需要它——误开反而让正则变慢、匹配失控。
