VSCode全局替换需手动检查search.exclude、文件类型过滤、正则开关和写入机制四重设置；Replace All仅内存修改，Replace in Files才真正写入磁盘并自动处理未打开文件。
VSCode 的全局替换不是“输完就换”，而是默认被 search.exclude、文件类型过滤、正则开关和写入机制四重拦住——不手动检查这几点，90% 的“没生效”都是假失败。
为什么替换了但文件没变？Replace All 和 Replace in Files 根本不是一回事
点右上角的 Replace All 按钮，只是把匹配内容在内存里改了；文件标题栏出现 ● 圆点，不代表已落盘。真正写入磁盘的操作是 Replace in Files（两个重叠文档图标），它会逐个打开命中文件、执行替换、并触发保存逻辑。
- 没打开过的文件不会被
Replace All触达，但Replace in Files会自动加载并修改 - 如果某文件处于只读状态（右下角显示
Read-only），Replace in Files也会跳过，需先解除只读或用管理员权限运行 VSCode - 启用
Auto Save（菜单栏 File > Auto Save →afterDelay）可避免漏存，但不能替代确认操作
搜不到 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更准，但注意要转义括号：myFunction\s*\(\) - 限定文件类型：在
files to include输入框填*.ts,*.js（逗号后不加空格），避免 JSON/YAML 配置文件被波及 - 导入语句单独处理：命名导入如
import { myFunction } from './utils'不会被myFunction()匹配到，得另起一次正则搜索：import\s+{[^}]*myFunction[^}]*}
多行替换怎么做？\n 必须配合正则模式，且不能手敲回车
想把两行代码：
console.log('a');
console.log('b');
替换成三行：
debugger;
console.log('a');
console.log('b');
就不能在查找框里按 Enter 换行——那只是 UI 换行，不是正则意义上的 \n。
- 必须先点
.*启用正则模式 - 查找内容填：
console\.log\('a'\);\nconsole\.log\('b'\);（点号和括号都要转义） - 替换内容填：
debugger;\nconsole.log('a');\nconsole.log('b'); - 更稳妥的做法：用捕获组保留结构，例如查找
(console\.log\('a'\);)\n(console\.log\('b'\);)，替换为debugger;\n$1\n$2
正则里混入中文括号、全角空格或未转义的 .、/，会导致整个表达式静默失效——界面不报错，也不匹配，建议先关掉 .* 确认普通文本能搜到，再逐步加正则。
