全局替换必须严格控制风险：先限定文件范围（如*.ts）、预览匹配项、启用正则捕获组（如getuserinfo\(([^)]*)\)→fetchuser($1)），替换后务必通过git diff验证变更，避免误改注释、字符串或非目标上下文。
全局替换不是“搜完就替”，而是重构前必须控制风险的操作。直接点说：不加范围限定、不预览匹配、不启用正则捕获组的全局替换，等于在代码库上蒙眼扫雷。
用 Ctrl+Shift+H 打开替换面板，但别急着输内容
先确认当前工作区已加载完整项目（特别是 node_modules 未被意外排除）。打开面板后，VS Code 默认会搜索整个工作区——这很危险。你真正需要的从来不是“全部文件”，而是“所有 .ts 文件”或“src/api/ 下的 .js 和 .ts”。所以第一步永远是填 Include files 字段：
-
*.ts—— 仅 TypeScript 文件 -
src/**/*.{js,ts}—— 指定目录 + 多扩展名 -
!**/test.{js,ts},!**/*.d.ts—— 排除测试和声明文件（注意用英文逗号分隔）
漏掉这步，package-lock.json 或 dist/ 里的字符串也可能被误改，且不会报错，只会在构建时静默失败。
函数重命名必须用正则捕获组，否则参数会丢
比如要把 getUserInfo(id) 改成 fetchUser(id)，如果只写查找：getUserInfo(，替换：fetchUser(，那所有调用都会变成 fetchUser(id) —— 看似对，但实际可能漏掉带默认值、解构、多参数等变体，更糟的是：如果原调用是 getUserInfo(id, true)，这种纯字符串替换会变成 fetchUser(id, true)，看似保留了参数，但你根本没验证过新函数是否接受第二个参数。
正确做法是启用 .* 图标，然后：
- 查找：
getUserInfo$$([^)]*)$$（注意括号要转义） - 替换：
fetchUser($1) - 勾选
Aa（区分大小写），避免把getuserinfo或GetUserInfo也卷进来
这样 $1 会原样捕获括号内所有内容，包括空格、换行、逗号、默认值，确保语义不变。
替换后别直接保存，先看 git diff
VS Code 的“全部替换”执行完，所有文件只是标记为已修改，还没写入磁盘。这时最该做的不是 Ctrl+S，而是切到终端运行：
-
git status—— 确认只有预期文件被修改 -
git diff --no-color—— 快速扫一眼所有变更，重点看是否出现意外的跨行替换、注释被波及、或正则过度匹配（比如把user.getUserInfo里的getUserInfo也替了） - 如果用了正则，尤其要检查
console.log类日志是否被连带修改（它们常和业务函数混在同一行）
很多重构问题不是出在替换逻辑，而是出在“以为改对了”的错觉里——git diff 是唯一能打破这种错觉的低成本验证手段。
真正难的从来不是怎么按快捷键，而是判断哪一行该进 Include files，哪个括号该转义，以及看到 $1 时，有没有花三秒想想它到底捕获了什么。
