在VS Code多文件搜索中，需先打开文件夹或工作区才能启用Ctrl+Shift+F；搜索范围可通过files to include使用glob语法限定，如src/*/.ts；替换前应预览并注意正则转义与捕获组格式。
搜索框里输什么才能跨文件匹配
VS Code 的多文件搜索依赖正则表达式和通配符，不是所有输入都能触发跨文件扫描。默认情况下，只要在左侧搜索面板的 Search 框里输入内容，它就会自动搜索当前工作区所有可读文件（排除 .git、node_modules 等忽略项）。但要注意：如果没打开文件夹或工作区，只打开了单个文件，Ctrl+Shift+F 会灰掉——必须先用 File > Open Folder 加载整个项目。
常见误操作：在未保存的临时文件中按 Ctrl+Shift+F，结果搜不到任何东西。这是因为 VS Code 默认不索引未加入工作区的孤立文件。
怎么精准限定搜索范围（路径/文件类型）
直接在搜索框下方的 files to include 输入框里填过滤条件，就能缩小范围。比如：
-
src/**/*.ts—— 只搜 TypeScript 源码 -
*.js,*.jsx—— 多后缀用英文逗号分隔 -
!**/test/**—— 排除 test 目录（注意开头的!） -
package.json—— 精确匹配某个配置文件
这些路径支持 glob 语法，但不支持正则。如果写错格式（例如漏掉 **/ 或多加空格），VS Code 不报错，只是静默忽略该规则，导致搜出一堆无关文件。
替换时为什么有些地方没被改？
多文件替换失败通常不是 bug，而是三个隐性限制在起作用：
- 只替换已打开文件夹中的文件（即工作区根目录下的文件），外部链接或符号链接默认不参与
- 文件权限不足时，VS Code 会跳过并显示“无法写入”提示，但不会中断整个替换流程
- 如果启用了
Use Exclude Settings and Ignore Files（搜索框右上角齿轮图标里的选项），那么.gitignore和settings.json中的files.exclude会生效，即使你手动写了files to include也覆盖不了
建议替换前先点左下角的 Replace All 旁的小箭头，选 Preview Replace，逐条确认是否命中目标位置。尤其当替换涉及 import 路径或 JSON 键名时，容易因大小写或引号类型（单/双）漏匹配。
正则替换怎么避免破坏代码结构
开启正则模式（搜索框左侧 .* 图标）后，$1、$2 这类捕获组引用是安全的，但要注意 JS 风格的正则语法限制：不支持 \K、不支持命名捕获组 (?<name>...)</name>（会报错），只认 (...) 和 $n。
典型场景：把 console.log('xxx') 替换成 debug('xxx')，可以这样写：
console\.log\((.*)\)
替换为：
debug($1)
关键点：. 和 (、) 必须转义，否则会被当作正则元字符；$1 不能写成 \1，后者在 VS Code 里无效。另外，如果原字符串含换行，正则默认不跨行匹配，得手动勾选 Match whole word 旁边的 Match newlines（图标是 \n）。
真正容易被忽略的是：正则替换一旦执行，无法用 Ctrl+Z 撤回所有改动，只能一个个文件手动撤销。所以批量操作前务必先备份或提交 Git。
