VSCode全局替换必须用“Replace in Files”（两个重叠文档图标）才能真正写入磁盘，而“Replace All”仅修改内存；需确保已通过File→Open Folder加载完整工作区，搜索面板显示“在文件中查找”，并检查search.exclude排除规则及正则语法（如用$1而非）。
VSCode 的“在所有文件中替换”不是输完就生效，必须用 Replace in Files（两个重叠文档图标），而不是编辑器右上角的 Replace All —— 后者只改内存，不写磁盘，文件标题栏出现 ● 也不代表已保存。
确认工作区已正确加载
全局替换只对“打开的文件夹”生效。如果右下角状态栏显示 No folder opened 或只显示一个文件名（如 index.ts），说明你没加载项目根目录。
- 必须通过
File → Open Folder…打开顶层文件夹（例如my-project/），不能只用Open File… - 多根工作区（
.code-workspace）也支持，但要检查每个子文件夹图标旁没有感叹号（表示未加载或被files.exclude隐藏） - 若搜索面板左上角显示的是“在当前文件中查找”（灰色小字），点右上角 ⋯ → 勾选“在文件中查找”，或直接按
Ctrl+Shift+F强制唤起全局模式
绕过默认排除规则（比如 node_modules）
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/
限定文件类型与启用正则的关键操作
盲目全局替换极易误伤注释、字符串或第三方代码。精准控制范围和匹配逻辑比“快”更重要。
- 在“包含文件”框中填
**/*.ts（TypeScript）、**/*.vue（Vue）、**/*.css（CSS）等，避免全量扫盘拖慢响应 - 启用正则（
.*图标）后，捕获组引用必须用$1、$2，不是；\n - 防误改：开启
ab（全字匹配）可避免把foo替换成foobar里的部分；但注意它对中文无效，且无法跳过字符串字面量 —— VSCode 原生搜索无语法感知能力
替换后文件未更新？先查这三处
即使看到预览结果，也可能因底层机制导致修改未落盘或被跳过。
- 文件是只读状态（右下角显示
Read-only）：VSCode 会跳过，需手动解除只读，或以管理员权限运行 VSCode - 未真正触发写入：确认你点的是
Replace in Files（两个重叠文档图标），不是Replace All（单个右向箭头） - Auto Save 没用：虽然启用了
File > Auto Save，但 VSCode 不会自动保存被Replace in Files修改的文件 —— 必须手动按Ctrl+K S（保存全部）或逐个保存
最常被忽略的是：正则启用后，区分大小写 和 全字匹配 开关会直接影响捕获是否成功；而中文括号、全角符号这类“看起来一样”的字符，会导致整个正则静默失效且无报错提示。
