VSCode全局替换不生效主因是混淆Replace All与Replace in Files，且受search.exclude、files to include/exclude、正则开关四层过滤影响；Replace in Files（重叠文档图标）才真正写入磁盘，Replace All仅改内存高亮结果。
VSCode全局替换不生效，90%是因为没搞清Replace All和Replace in Files的区别，以及search.exclude、files to include/exclude、正则开关这四层过滤机制在静默拦截。
Ctrl+Shift+H ≠ 替换已发生
点开搜索面板后按Ctrl+Shift+H（Win/Linux）或Cmd+Shift+H（macOS），只是打开「在文件中替换」视图；真正写入磁盘的是点击右上角两个重叠文档图标（Replace in Files），它会自动加载未打开的文件、执行替换、触发保存逻辑。
-
Replace All按钮只改内存中的高亮结果，文件标题栏出现●不代表落盘，关掉再打开就还原 - 只读文件（右下角显示
Read-only）会被Replace in Files跳过，需手动解除只读或用管理员权限运行VSCode - 启用
Auto Save（File > Auto Save）不能替代确认操作，它只保你当前编辑的文件，不保批量替换结果
search.exclude 是默认拦路虎
VSCode默认排除**/node_modules/**、**/.git/**、**/dist/**，靠的是search.exclude配置项——它不判断你“是不是真想搜”，路径匹配就跳过。
- 检查方式：
Ctrl+Shift+P→ 输入Preferences: Open Workspace Settings (JSON)→ 查看是否有search.exclude条目 - 临时绕过：搜索面板右上角点
⋯→ 取消勾选「使用排除设置」（仅本次生效） - 通配符陷阱：
**/api/**会排除所有含api的子目录（如src/utils/apiClient），而src/api/**才只排除顶层src/api
files to include/exclude 决定实际扫描范围
这个字段控制本次搜索真正扫哪些文件，优先级高于search.exclude，但只影响当前操作，不改工作区设置。
- 限定TS文件：
src/**/*.ts比*.ts更安全，避免误改node_modules/@types里的声明文件 - 排除测试文件：
!**/*.test.ts, !__tests__/**（英文逗号分隔） - HTML模板专用：
**/*.html, **/*.htm，加!node_modules/**防污染 - 别信模糊路径：填
components可能命中src/components和legacy/components，显式写src/components/**更可控
正则替换必须用$1，不是\1
VSCode替换引擎用JavaScript正则语法，捕获组引用必须是$1、$2，\1会被当普通字符处理。
- 正确示例：查
console\.log\(["'](.+?)["']\)，换debug($1)——$1才能取到引号内内容 - 字面量
$要写成$$，比如想输出$abc，得填$$abc -
(?:)是非捕获组，不占编号，别指望它生成$1 - 跨行匹配需点
.按钮（让.匹配换行符），但多数场景不需要，开了反而容易误匹配整段代码块
最常被忽略的其实是「先点Find All再点Replace All」——VSCode的Replace All只作用于当前已高亮的匹配项，不是实时扫描。没手动触发查找，就等于没告诉它去哪找。
