真正写入磁盘的操作只有replace in files；replace all仅修改内存，关掉标签页即丢失更改；未打开或只读文件会被自动跳过，需手动解除限制并确认范围与正则设置。
VSCode 的全局替换不是“输完就换”，真正写入磁盘的操作只有 Replace in Files；点 Replace All 只改内存，关掉标签页就丢修改。
为什么替换了但文件没变？
常见错误现象：标题栏出现 ● 圆点、搜索面板显示“已替换 X 处”，但打开文件发现内容未更新，Git 也无变更。
-
Replace All（单文档图标）只在当前已打开的编辑器中做内存替换，不保存、不写磁盘 -
Replace in Files（两个重叠文档图标）才会逐个加载命中文件、执行替换、触发保存逻辑 - 未打开的文件、只读文件（右下角显示
Read-only）会被Replace in Files自动跳过 - 若启用了 Auto Save，仍需手动确认替换动作——它不会自动执行
Replace in Files
怎样确保只改目标文件（比如 *.vue 或 src/api/**）？
文件范围控制靠的是 files to include 和 search.exclude 两层过滤，二者行为完全不同。
- 在替换面板中填
files to include：如*.vue、src/**/*.ts、{components,pages}/**/*.css，这是白名单，显式限定作用域 -
search.exclude是黑名单，默认含**/node_modules/**、**/dist/**等——哪怕你正要修node_modules里的 patch，它也会静默跳过 - 检查方式：
Ctrl+Shift+P→Preferences: Open Workspace Settings (JSON)→ 查看search.exclude条目 - 临时绕过排除：搜索面板右上角 ⋯ → 取消勾选「使用排除设置」（仅本次生效）
- 通配符陷阱：
**/api/**会匹配src/utils/apiClient，真要限定顶层目录得写src/api/**
正则替换总失败？三个硬性条件必须同时满足
90% 的正则失效，不是语法错，是环境没配对。
- 必须手动点亮
.*图标（或按Alt+R/Cmd+Option+R），右下角出现Regex标签才算启用 - 替换字段只认
$1、$2，写\1或${1}会静默失败；想输出字面量$得写$$ -
.永远不匹配换行符，跨行匹配必须用[\s\S]或[^]，例如多行注释：/\*[\s\S]*?\*/ - 贪心陷阱：
"(.*)"会从第一个"吞到文件末尾最后一个"，应改用非贪婪："(.*?)" - UI 上那个 ↵（“匹配换行符”）按钮仅影响预览折叠行为，不改变正则引擎逻辑
替换前最易被忽略的验证动作
VSCode 的 Replace in Files 不提供 diff 预览、不二次确认、跨文件修改无法一键撤回。
- 先按
Enter或点Find in Files，确认左侧结果树只列出你预期的文件和行号 - 逐个点击匹配项前的 ▶ 展开上下文，重点看前后几行——别把
// console.log(...)也替了 - 检查
files to include是否为空：为空时默认搜全部可读文件，但受search.exclude限制 - 大文件或模糊正则（如
[\s\S]*error）可能卡死或触发Too many results，建议先在小范围测试
真正难的从来不是怎么写正则，而是判断哪些上下文该进、哪些该出——比如 JSX 中的 className 值含换行、CSV 里带引号的字段、TS 类型注解里的字符串字面量。这些地方一旦漏掉 [\s\S] 或引号边界处理，替换就会越界。
