Ctrl+Shift+H（Win/Linux）或Cmd+Shift+H（macOS）是VSCode全局替换的正确入口，直接打开带查找与替换框的视图；Ctrl+Shift+F仅打开搜索面板，非替换起点。
Ctrl+Shift+H 才是全局替换的正确入口，不是 Ctrl+Shift+F
很多人一上来就按 Ctrl+Shift+F，结果只打开搜索面板、没替换框——这根本不是替换操作的起点。Ctrl+Shift+H（Windows/Linux）或 Cmd+Shift+H（macOS）才是直接进入「在文件中替换」视图的快捷键，它默认带出查找+替换双输入框，省去手动展开步骤。
常见错误现象：按了 Ctrl+Shift+F 后点右上角“替换”箭头，再输内容，看似能换，但此时搜索范围容易卡在“当前文件”，尤其上次操作残留了范围设置；而 Ctrl+Shift+H 每次都是干净状态，更可控。
限定路径必须填在 “files to include” 里，不是靠文件夹图标选
想只改 src/utils 下的导入路径？别只点右上角文件夹图标选目录——它只影响“当前搜索范围”，不参与后续替换逻辑，且无法保存为条件。真正起作用的是下方的 files to include 输入框。
- 填
src/**/*.ts→ 精确匹配所有 TypeScript 文件路径 - 填
**/api/*.js→ 只扫 api 目录下的 JS 文件 - 填
!node_modules/**不生效；排除必须用files to exclude字段，单独填node_modules
路径写错会导致零匹配，VSCode 不报错也不提示，只会安静地显示“无结果”。建议先用简单字符串（如 http://）测试通路是否走通。
替换 import 路径时，正则捕获组必须用 $1，且 .* 按钮要点亮
例如要把 import { foo } from 'old-lib' 换成 import { foo } from 'new-lib'，不能只输文字替换——路径可能分散在几十个文件、格式不统一（单引号/双引号/相对路径/绝对路径）。得用正则：
查找：from\s+['"]([^'"]+)['"]
替换：from '$1'.replace(/old-lib/, 'new-lib') —— 错！VSCode 不支持函数式替换。
正确做法：
- 先点亮 .* 按钮（启用正则）
- 查找填：from\s+['"]old-lib['"]
- 替换填：from 'new-lib'
或更灵活：
- 查找填：from\s+['"]([^'"]*old-lib[^'"]*)['"]
- 替换填：from '$1'.replace('old-lib', 'new-lib') —— 还是错！
真正可用的：
- 查找：from\s+['"]([^'"]*?)old-lib([^'"]*?)['"]
- 替换：from '$1new-lib$2'
注意：$1 和 $2 是捕获组，\1 会原样输出，不解析。
Replace All 不等于已保存，未 Ctrl+S 的修改不会进 Git
点击 Replace All 后，编辑器标题栏出现 ● 圆点，只是表示“有未保存更改”，不代表文件已写入磁盘。Git 状态不会变，构建也不会感知到变化。
- 必须逐个文件
Ctrl+S，或全选标签页后Ctrl+Shift+S - 如果改了 20 个文件，只保存了其中 5 个，Git diff 只显示这 5 个
- 大项目里，部分文件可能因只读权限或被其他进程占用而无法保存，VSCode 不弹窗警告，只在右下角闪一下“保存失败”
最稳妥的做法：替换前 git add -A && git commit -m "backup before path replace"；替换后立刻 git status 确认变更已落地。路径类替换一旦出错，往往牵连编译和运行时，比文本替换更难回滚。
