ctrl+shift+f（windows/linux）或cmd+shift+f（macos）是vscode唯一全局搜索快捷键，作用于当前激活工作区而非所有打开文件夹；需确认右下角显示“workspace”、排除设置未拦截、替换时使用replace in files而非replace all，并开启正则时用$1引用捕获组。
Ctrl+Shift+F 只在当前工作区生效，不是“所有打开的文件夹”
VSCode 的全局搜索替换（Ctrl+Shift+F）作用范围由**当前激活的工作区**决定，而不是你电脑上所有已打开的文件夹或窗口。如果你只是把多个项目文件夹拖进同一个 VSCode 窗口，但没创建多根工作区，那它默认只搜第一个被打开的文件夹——其余“看似在窗口里”的目录根本不在搜索范围内。
常见错误现象：在侧边栏看到两个文件夹图标，右下角却显示 Folder 而非 Workspace；此时 Ctrl+Shift+F 实际只覆盖焦点所在文件所在的那个根目录。
- 确认是否为真·多根工作区：右下角必须显示 Workspace，且状态栏路径旁有多个文件夹图标
- 必须通过
Ctrl+Shift+P→Add Folder to Workspace逐个添加，不能靠拖拽或Open Folder - 务必执行
File → Save Workspace As生成.code-workspace文件，否则关闭即丢失结构 -
.code-workspace文件中folders字段必须是含多个path的数组，不能是空或单条
Replace in Files 才真正写入磁盘，Replace All 不落盘
点搜索面板右上角的 Replace All 按钮，只是在内存里改了已打开文件的编辑器内容，文件标题栏出现 ● 圆点 ≠ 已保存。真正触发磁盘写入的是 Replace in Files（两个重叠文档图标），它会自动加载未打开的命中文件、执行替换、调用保存逻辑。
容易踩的坑：
- 某文件处于只读状态（右下角显示 Read-only），
Replace in Files会静默跳过，不会报错 - 没打开过的文件，
Replace All根本触达不了；但Replace in Files会加载并修改 - 启用
Auto Save（afterDelay）能减少漏存，但不能替代手动确认Replace in Files操作
正则替换必须开 .* 按钮，且捕获组只能用 $1 不是 \1
VSCode 默认关闭正则引擎。.* 图标不亮时，你输的 \d、^、[sS] 全是普通字符——不是匹配失败，是压根没走正则逻辑。右下角出现 Regex 标签且 .* 为蓝色，才是启用成功。
JavaScript 正则引擎规则严格：
- 捕获组引用必须写
$1、$2；写\1或$$1会静默失效（界面不报错，也不替换） - 要字面量输出
$1，得写成$$1 - 中文括号、全角符号、未转义的
.或/会导致整个正则失效，且无提示 - 跨行匹配需勾选
.*旁的 dotAll 模式，或用[\s\S]*
search.exclude 是静默拦截器，不是“建议忽略”
search.exclude 配置项是硬性过滤规则，默认排除 **/node_modules/**、**/.git/**、**/dist/**。它不区分你“是不是真想搜”，只要路径匹配就跳过——哪怕你正要批量修 node_modules 里的 patch 文件。
排查方式：
- 按
Ctrl+Shift+P→ 输入Preferences: Open Workspace Settings (JSON)→ 查看是否有search.exclude条目 - 临时绕过：搜索面板右上角点击
⋯→ 取消勾选 使用排除设置（仅本次生效） - 通配符陷阱：
**/api/**会排除所有含api的子目录（如src/utils/apiClient），而src/api/**才只排除顶层src/api - 若某根目录首次加载后搜索为空，等右下角状态栏从 Indexing 变为就绪再试
真正跨项目生效的关键，从来不是快捷键本身，而是工作区结构 + 排除配置 + 写入机制这三者的对齐。任何一环断掉，Ctrl+Shift+F 都会变成“看起来在跑，其实没动”。
