vscode批量替换需绕过四重机制：工作区加载、search.exclude过滤、正则开关开启、使用replace in files而非replace all；否则仅内存修改或跳过未开/只读文件。
VSCode批量全局替换特定字符，不是输完就生效，而是默认被四重机制拦住：工作区未加载、search.exclude静默过滤、正则开关未开、点错按钮用了Replace All而非Replace in Files——这四点不检查，90% 的“没换成功”都是假失败。
为什么替换了但文件内容没变？
最常见错觉是点了右上角的Replace All，以为万事大吉。其实它只在内存里改了当前已打开文件的副本，标题栏出现●圆点≠已落盘；真正写入磁盘的是Replace in Files（两个重叠文档图标），它会自动加载未打开文件、执行替换、触发保存逻辑。
- 未打开的文件完全不会被
Replace All触达 - 只读文件（右下角显示
Read-only）会被Replace in Files跳过，需手动解除或用管理员权限运行 VSCode - 启用
Auto Save（File > Auto Save）能减少漏存，但不能替代你确认操作
搜不到 src/api 或 node_modules？search.exclude 在拦路
VSCode 默认排除**/node_modules/**、**/.git/**、**/dist/**，靠的就是search.exclude配置。它不区分“你是不是真想搜”，路径匹配就跳过——哪怕你正要修node_modules里的 patch 文件。
- 检查方式：按
Ctrl+Shift+P→ 输入Preferences: Open Workspace Settings (JSON)→ 查看是否有search.exclude条目 - 临时绕过：搜索面板右上角点击⋯ → 取消勾选「使用排除设置」（仅本次生效）
- 路径陷阱：
**/api/**会排除所有含api的子目录（如src/utils/apiClient），而src/api/**才只排除顶层src/api
怎么只改 JS/TS 里的函数调用，不碰字符串和注释？
纯文本搜myFunction会误伤'myFunction'或// myFunction is deprecated。必须用正则 + 单词边界收窄范围，再配合文件类型限定。
- 基础防护：开启
.*按钮，搜\bmyFunction\b（\b是单词边界，避开myFunctionHelper） - 调用强化：搜
myFunction\s*\(\)（注意括号要转义），比\bmyFunction\b更准，但无法跳过字符串字面量 - 限定文件：在「包含文件」框填
*.ts,*.js（逗号后不加空格），避免 JSON/YAML 配置文件被波及 - 导入语句单独处理：
import { myFunction } from './utils'不会被myFunction()匹配到，得另起一次正则：import\s+{[^}]*myFunction[^}]*}
多行替换和正则捕获组怎么写才不翻车？
VSCode 正则引擎是 JavaScript 风格（ECMAScript），不支持\K或(?等 PCRE 特性，但基础能力足够覆盖 90% 场景。关键在语法细节和引用规则。
- 换行符必须用
\n，且必须开启.*按钮（即正则模式）才能生效 - 捕获组引用必须用
$1、$2，不是\1或$0；$在替换字段里是特殊字符，要输出字面量$得写成$$ - 示例：把
console.log('old')换成console.debug('new')，查console\.log\('([^']+)'\)，换console.debug('$1') - 性能警告：避免无限制
.*开头（如.*error.*），易卡顿；匹配项超 10,000 行时右下角会显示Too many results，应先限定*.ts等后缀
真正危险的不是不会用，而是没意识到 VSCode 的替换没有语法感知——它不管你是改变量名还是改字符串，也不管你是否在注释里。所有“精准”都靠你自己用正则锚定上下文，漏掉一个\b或写错一个\n，就可能批量污染代码。
