VSCode跨文件夹批量替换需用Replace in Files而非Replace All，后者仅内存修改；文件需可写、工作区已打开、search.exclude未误筛、正则引用用$1、中文符号须转英文半角。
VSCode跨文件夹批量全局替换不是“输完就换”，而是默认被四重机制拦住——不手动检查，90% 的“没生效”都是假失败。
为什么 Replace All 按了但文件内容没变？
点击搜索面板右上角的 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 配置。它不判断你“是不是真想搜”，只要路径匹配就跳过。
- 检查方式：按
Ctrl+Shift+P→ 输入Preferences: Open Workspace Settings (JSON)→ 查看是否有search.exclude条目 - 临时绕过：搜索面板右上角点击
⋯→ 取消勾选使用排除设置（仅本次生效） - 通配符陷阱：
**/api/**会排除所有含api的子目录（如src/utils/apiClient），而src/api/**才只排除顶层src/api
正则替换分组引用必须用 $1，但容易错写成 或 $1
VSCode 使用 JavaScript 正则引擎，捕获组引用统一用 $1、$2，不是 ，也不是 $1（后者是常见误抄）。
- 开启
区分大小写或全字匹配可能导致分组无法捕获，建议先关闭这两项验证正则逻辑 - 中文括号、全角符号（如（、））会让整个正则失效且无报错提示，务必用英文半角
- 替换内容含换行符时，
$表示换行，不是字面量反斜杠加 n；要输字面量\n
Ctrl+Shift+H 失效？你可能根本没打开工作区
如果右下角状态栏显示 No folder opened，Ctrl+Shift+H 实际退化为单文件替换，不会扫描子目录——这不是 bug，是设计行为。
- 必须通过
File → Open Folder…加载项目根目录，而非File → Open File… - 多根工作区（
.code-workspace）也支持全局搜索，但需确认所有文件夹都已加载（无感叹号图标） - 搜索结果为空时，优先检查
files to include是否留空，以及files to exclude是否误筛目标路径
最隐蔽的问题往往不在正则或范围，而在你没意识到 VSCode 的“替换”操作分两层：内存预览 vs 磁盘写入。每次点 Replace in Files 前，花三秒确认右下角是否显示正确的工作区路径、search.exclude 是否被临时禁用、以及目标文件是否处于可写状态——这比事后 git revert 快得多。
