ctrl+shift+h没反应是因为未打开文件夹工作区；需通过file→open folder加载顶层目录，检查状态栏是否显示文件夹名，多根工作区需确认无感叹号，再用files to include限定路径并点find all刷新匹配。
Ctrl+Shift+H没反应？先确认工作区是否加载了目标文件夹
VSCode 的全局替换只对「已打开的文件夹工作区」生效，不是对磁盘路径或未加载的子目录。如果你只是打开了单个文件，或者通过“添加文件夹到工作区”但没保存为 .code-workspace，Ctrl+Shift+H（Win/Linux）或 Cmd+Shift+H（macOS）会静默退化为当前文件替换。
检查左下角状态栏：显示 No folder opened 或仅一个文件名（如 index.ts），说明没加载有效工作区。必须通过 File → Open Folder… 打开包含目标子文件夹的顶层目录（比如 my-project/），才能让搜索覆盖其全部子级。
- 多根工作区也支持，但需确认目标文件夹图标旁无感叹号（表示加载失败或被排除）
- 右上角搜索面板的文件夹图标默认显示“整个工作区”，点它可临时切换为“选定文件夹”——但这个“选定”仅限于已加载的根目录，不能手动输入任意路径
只想改某个子文件夹？用 files to include 精确限定范围
VSCode 不允许直接在快捷键里指定路径，但可在搜索面板中用通配符约束范围。关键操作是点击搜索框右侧的 … 图标，展开 files to include 输入框。
- 想只改
src/api/下所有文件：src/api/** - 只改
components/里的 Vue 文件：components/**/*.vue - 注意：
**/api/**会匹配任意深度含api的路径，而api/**只匹配顶层api/目录 - 如果目标文件夹名含空格或特殊字符（如
my utils/），需用引号包裹："my utils/**"，否则解析失败
替换了但部分文件没变？检查 search.exclude 是否误拦
即使文件夹已加载，VSCode 仍可能因配置跳过其中文件。默认排除 node_modules、.git、dist 等，但自定义规则更危险：比如项目 .vscode/settings.json 里写了 "search.exclude": { "**/legacy/**": true }，那 src/legacy/utils.ts 就不会参与替换。
- 打开命令面板
Ctrl+Shift+P→ 输入Preferences: Open Workspace Settings (JSON)，检查search.exclude和files.exclude - 临时绕过所有排除规则：在搜索面板右上角点击齿轮图标 → 取消勾选
Use Exclude Settings and Ignore Files（仅本次生效） - 修改后务必点
Find All预览结果，确保目标文件出现在列表中——没出现就是被过滤了
正则替换跨文件夹时，$1 捕获组为什么失效？
常见错误是正则写对了，但替换字段用了 \1 或漏了括号。VSCode 使用 JavaScript 正则引擎，捕获组引用严格要求 $1、$2，且括号必须存在、编号连续。
- 要提取 import 路径并复用：
import\s+.*?\s+from\s+['"](.+?)['"]→ 替换为import $1 from '$1'，$1才生效 -
(?:...)是非捕获组，不生成$1；中文括号（）或全角符号会导致正则完全不匹配，且无报错提示 - 替换字段中字面量
$必须写成$$，否则会被当捕获组前缀处理 - 启用正则后，
.默认不匹配换行符；若需跨行匹配（如替换多行注释块），要点亮.按钮（即“跨行匹配”开关）
真正容易被忽略的是：VSCode 的“全部替换”只作用于当前已高亮的匹配项，不是实时扫描。哪怕你改了 files to include 规则，也必须手动点一次 Find All，否则旧缓存结果会被误替换。
