Replace in Files 是真正写入磁盘的操作；Replace All 仅内存修改，文件标题栏 ● 不代表已保存。
Replace in Files 才是真正写入磁盘的操作
点搜索面板右上角的 Replace All 按钮，只是把匹配内容在内存里改了；文件标题栏出现 ● 圆点，不代表已落盘。真正触发保存逻辑、修改未打开文件、写入磁盘的操作是 Replace in Files（两个重叠文档图标）。如果替换后文件没变，八成是因为误点了 Replace All 而非 Replace in Files。
以下情况会跳过写入：
- 目标文件处于只读状态（右下角显示 Read-only），
Replace in Files会静默跳过，不会报错 - 文件被其他进程占用（如 Webpack 正在监听
dist/），VSCode 可能无法获取写权限 - 路径中含中文或空格但未用引号包裹（极少，但某些扩展或自定义脚本会出问题）
路径替换必须检查 search.exclude 和 files.exclude
VSCode 默认跳过 **/node_modules/**、**/.git/**、**/dist/**，靠的是 search.exclude 配置项。它不区分你“是不是真想改路径”，只要路径匹配就过滤——比如你想批量把 src/utils/api.js 改成 src/lib/api.ts，但 src/utils/ 被写进了 search.exclude，那整个目录直接消失在搜索结果里。
检查方式：
- 按
Ctrl+Shift+P→ 输入Preferences: Open Workspace Settings (JSON) - 查找
search.exclude或files.exclude字段 - 临时绕过：搜索面板右上角 ⋯ → 取消勾选 使用排除设置（仅本次生效）
注意通配符陷阱：**/api/** 会排除所有含 api 的子目录（如 src/test/apiClient），而 src/api/** 才只排除顶层 src/api。
正则模式下路径替换要小心捕获组和转义
路径中常含 /、.、- 等特殊字符，普通文本替换容易漏掉斜杠或误匹配。启用 .* 图标开启正则后：
- 斜杠不用转义：
src/components/Button直接写，不是src\/components\/Button - 点号必须转义：
\.js匹配字面量.js，否则.js会匹配任意字符 +js - 捕获组引用统一用
$1、$2（VSCode 使用 JS 正则引擎，不支持\1） - 中文路径或全角符号会导致正则静默失效，无任何提示
示例：把 import { foo } from 'src/api/user' 改成 import { foo } from '@/api/user'，可搜 from 'src/(.*)'，替换成 from '@/$1'。
限定范围时用 glob 模式比盲目全项目更安全
全局替换路径极易波及配置文件、打包产物、甚至 package.json 里的字段。务必用 Include files 显式限定：
-
**/*.ts、**/*.js：只改源码，避开 JSON/YAML/MD -
src/**/*.{ts,js,tsx,jsx}：进一步收窄到源码目录 -
!**/node_modules/**单独写在Exclude files里不如直接删掉search.exclude中对应项来得可靠 - 避免用
**开头的宽泛模式，尤其项目含docs/或scripts/时，它们可能含硬编码路径
复杂路径重构（如从相对路径 ../../utils 改为别名 @/utils）建议先小范围测试：选一个子目录如 src/views/**，确认 diff 合理再推全量。
最易被忽略的一点：路径替换后，TypeScript 的 tsconfig.json 里 paths 配置、Webpack/Vite 的 resolve.alias 必须同步更新，否则编译或运行时直接报 Cannot find module —— VSCode 不会帮你检查这个。
