真正生效的操作是Replace in Files，它写入磁盘并自动处理未打开文件；Replace All仅内存修改，且默认受search.exclude、文件类型过滤、正则开关和写入机制四重拦截。
VSCode跨文件全局替换不是“输完回车就完事”，真正生效的操作必须触发磁盘写入，且默认被四重过滤规则静默拦截——不手动检查，90% 的“没换上”都是假失败。
Replace in Files 和 Replace All 根本不是一回事
点搜索框右侧的 Replace All 按钮，只是把匹配项在内存里改了；文件标题栏出现 ● 圆点，不代表已保存。真正写入磁盘的是 Replace in Files（两个重叠文档图标），它会逐个打开命中文件、执行替换、并触发保存逻辑。
- 没打开过的文件不会被
Replace All触达，但Replace in Files会自动加载并修改 - 如果某文件处于只读状态（右下角显示
Read-only），Replace in Files也会跳过，需先解除只读或用管理员权限运行 VSCode - 启用
Auto Save（菜单栏File > Auto Save）可避免漏存，但不能替代确认操作
search.exclude 是静默杀手，不是“建议忽略”
VSCode 默认排除 **/node_modules/**、**/.git/**、**/dist/**，靠的是 search.exclude 配置项。它不区分“你是不是真想搜”，只要路径匹配，就跳过——哪怕你正要批量修 node_modules 里的 patch。
- 检查方式：按
Ctrl+Shift+P→ 输入Preferences: Open Workspace Settings (JSON)→ 查看是否有search.exclude条目 - 临时绕过：搜索面板右上角点击 ⋯ → 取消勾选
Use Exclude Settings（仅本次生效） - 路径通配符陷阱：
**/api/**会排除所有含api的子目录（如src/utils/apiClient），而src/api/**才只排除顶层src/api
正则替换时，$1 和 不是你想的那样
启用正则后，$1 引用捕获组没问题，但
表示换行符，不是字面量反斜杠加 n；要输字面量，得写成 \n。另外，替换内容含缩进或空行时，粘贴进去的文本会自动按当前编辑器缩进设置对齐，可能意外改变格式。
- 替换多行 JSX 标签？必须开正则，并用
( | )匹配换行，不能直接敲回车 - 想保留原始缩进？先复制原始行再修改，避免空格/
Tab混用 - 常见误用：
console.log$$([^)]+)$$→logger.info($1)，注意括号和点号都要转义
文件类型限定必须手填，不能靠直觉
VSCode 不会自动识别你“想改 TS 文件”，files to include 字段必须手动填 *.ts 或 src/**/*.ts。填错一个字符（比如多加空格或逗号后留空格），整个范围就失效。
-
*.ts,*.js✅（逗号后无空格）｜*.ts, *.js❌（空格导致第二项被忽略） - 想排除
node_modules但又想扫其中某个子目录？用!node_modules/**+node_modules/my-patch/**组合 - 对 HTML 类名批量更新：
.old-comp-(w+)→.new-comp-$1，记得勾选Use Regular Expression
最常被跳过的其实是“未打开根目录”这个前提——右下角显示 No folder opened 时，Ctrl+Shift+H 实际退化为单文件替换；而大项目里漏搜，往往不是功能不行，是 search.useRipgrep 被关了，或者 files.watcherExclude 过度屏蔽导致新文件没被索引。
