VSCode不存在后台自动替换，所有替换均需手动触发；Ctrl+H仅限当前文件，Ctrl+Shift+H才是全局替换入口，须配合“包含/排除文件”精准限定范围，正则需注意转义、非贪婪匹配及$1引用，Replace All不自动保存，须确认预览并执行Replace All in Files落盘。
VSCode 里所谓“自动替换”，其实并不存在真正意义上的后台常驻式自动替换；所有替换都需你主动触发，但可以通过快捷键、正则和范围限定，做到“一击生效、覆盖精准”。关键不是等它自动动，而是让你每次操作都稳准快。
Ctrl+H 和 Ctrl+Shift+H 的区别必须分清
很多人以为 Ctrl+H 就能改全项目——它只作用于当前打开的文件。Ctrl+Shift+H 才是真正的全局替换入口，会扫描工作区中匹配条件的全部文件。如果你在 Ctrl+H 面板里点了“全部替换”，结果发现其他文件没变，不是 VSCode 坏了，是你根本没进对面板。
-
Ctrl+H：当前文件内查找替换（含多行、正则） -
Ctrl+Shift+H：跨文件替换，依赖“包含文件”和“排除文件”过滤 - 误用
Ctrl+H+ “全部替换” → 只改当前 tab，其余文件纹丝不动
“包含文件”不填，等于没限定范围
默认情况下，Ctrl+Shift+H 会搜整个工作区，包括 node_modules、dist、.git —— 这些目录早被 search.exclude 拦住了，但你未必知道它拦了什么。想只动 .vue 文件？必须手动在“包含文件”框里填 *.vue；想只改 src/api/ 下的 JS？填 src/api/**/*.js。
- 填
**/*.css→ 所有层级 CSS 文件 - 填
components/**/*.{ts,tsx}→ components 目录下所有 TS/TSX - 留空 → 依赖
search.exclude配置，极易漏掉或误伤 - 右上角 ⋯ → 可临时关闭“使用排除设置”，用于紧急修
node_modules里的 patch
正则替换里最容易翻车的三件事
启用 .* 模式后，\n、$1、点号转义这些细节一旦错，要么不匹配，要么全删光。比如把 console.log("xxx") 换成 logger.info("xxx")，写成 console.log\("(.*?)"\) 才对；写成 console.log\("(.*)"\) 就可能跨行吞掉后面代码。
-
.默认不匹配换行符，多行匹配必须用[\s\S]或开启dotAll（VSCode 不支持 flag，只能用[\s\S]） -
(.*?)是非贪婪，(.*)是贪婪——后者在长文本里极易捕获过多 -
\.、\(、\)等符号必须转义，否则被当元字符解析 - 替换字段里用
$1引用捕获组，别写成\1（那是旧语法，VSCode 不认）
Replace All 按钮不等于文件已保存
点完 Replace All，文件标题出现 ● 圆点，只是编辑器内存改了；关掉窗口前没手动 Ctrl+S 或 Ctrl+K S，所有改动就丢了。更隐蔽的是：未打开的文件，Replace All 根本不会触达——只有 Replace in Files（两个重叠文档图标）才会真正加载、修改、保存。
- 右上角按钮是
Replace All（仅当前面板预览结果） - 搜索结果列表下方的
Replace All in Files（带文件路径图标）才是落盘操作 - 只读文件会被跳过，右下角显示
Read-only时需先解除或提权运行 - 建议开
Auto Save（afterDelay），但不能替代你确认是否真写入磁盘
真正麻烦的从来不是怎么输正则，而是你点下“全部替换”前，有没有花十秒扫一眼预览列表里到底哪些文件、哪几行被框进去了——尤其当 search.exclude 被动生效、或 glob 路径写宽了的时候。
