“replace all”仅修改内存缓存，“replace in files”才真正写入磁盘；search.exclude默认静默排除node_modules等路径；文件范围需显式设置files to include；正则替换用$1而非\1，且须英文半角。
“Replace All”只是改内存，“Replace in Files”才真正写入磁盘——不点对按钮，90% 的“批量替换没生效”都是白忙活。
点错了按钮：Replace All ≠ Replace in Files
在搜索面板里点右上角的 Replace All 按钮，VSCode 只是在已打开文件的编辑器缓存里做修改，文件标题栏出现 ● 圆点 ≠ 已保存。它根本不会触达未打开的文件，也不会触发自动保存逻辑。
-
Replace in Files（两个重叠文档图标）才是真正的全局写入操作：它会逐个加载命中文件、执行替换、调用保存流程 - 如果某文件是只读状态（右下角显示
Read-only），Replace in Files会跳过，不会报错，也不会提醒 - 启用
Auto Save（File > Auto Save→afterDelay）能减少漏存，但不能替代你确认是否点了Replace in Files
搜不到文件？search.exclude 在静默拦截
VSCode 默认通过 search.exclude 排除 **/node_modules/**、**/.git/**、**/dist/** 等路径，但它不区分你“是不是真想搜”，只要路径匹配就跳过。
- 检查方式：按
Ctrl+Shift+P→ 输入Preferences: Open Workspace Settings (JSON)→ 查看是否有search.exclude条目 - 临时绕过：搜索面板右上角点击
⋯→ 取消勾选使用排除设置（仅本次生效） - 通配符陷阱：
**/api/**会排除src/utils/apiClient，而src/api/**才只排除顶层src/api
限定范围：用 “包含文件” 而不是靠猜
别依赖“我刚打开了 src 目录所以应该能搜到”，VSCode 全局搜索默认作用于整个工作区，但实际范围由 files to include 显式控制。
- 只改 Vue 文件？在
files to include输入框填*.vue（逗号后不加空格） - 只改 CSS 且限定在 components 和 pages 下？填
{components,pages}/**/*.css - 想排除 legacy.css？在
files to exclude填*/legacy.css - 路径支持 glob，但不支持正则；
**匹配多级子目录，*只匹配单层
正则替换：捕获组引用必须用 $1，不是 \1
VSCode 使用 JavaScript 正则引擎，分组引用统一用 $1、$2，不是 \1；而且大小写、全字匹配开关会影响捕获行为。
- 错误写法：
myFunc\((.*)\)→myFunc($1)（括号未转义，表达式直接失效） - 正确写法：
myFunc\s*\(([^)]*)\)→myFunc($1)，注意\s*容忍空格，[^)]*避免跨括号误匹配 - 中文括号、全角符号会导致正则静默失败，无任何提示——务必检查输入法是否为英文半角
- 替换前先点
Find All（放大镜图标），预览所有匹配项，比直接点Replace in Files安全十倍
最易被忽略的一点：VSCode 不会告诉你哪些文件被 search.exclude 拦截了，也不会在结果列表里提示“已跳过 X 个文件”。它只是安静地不显示——所以每次执行前，务必手动确认过滤设置和包含路径。
