直接全局替换函数名等易引发重构事故，因VSCode的Ctrl+Shift+F仅字符串匹配、无语义理解，需用文件过滤、正则、全词匹配和预览验证来保障安全。
直接改函数名、变量名或 API 调用前，不验证上下文就全局替换，90% 的重构事故都出在这一步。VSCode 的 Ctrl+Shift+F 本身不带语义理解，它只做字符串匹配——getUser 会同时匹配函数定义、调用、注释、字符串字面量甚至 JSON key，必须靠人工加约束来守住边界。
为什么 Ctrl+Shift+F 替换后代码报错？
常见错误现象：替换了 getUser，结果 user.name = getUser 这种赋值语句也被改成了 user.name = fetchUser，运行时报 TypeError: Cannot assign to read only property。
- 默认搜索不区分语法角色：它不管你是调用、定义、字符串还是注释里的文字
- 没排除构建产物和第三方代码：
node_modules/或dist/下的文件被误改，下次打包直接失败 - 大小写/全词未开启：搜
data结果把database和payload也卷进来了 - 正则未锚定：用
getUser\(\)搜，但实际有getUser(id, callback)和getUser()两种写法，后者没被覆盖
用 files to include 锁定源码范围
重构只该发生在你写的源码里，不是整个工作区。在 Ctrl+Shift+F 面板第二行 “包含的文件” 输入框中填入明确路径模式，比手动删搜索结果快十倍。
-
src/**/*.{ts,js,tsx,jsx}：只搜 TypeScript/JS 源码，跳过配置、测试、文档 -
!**/test/**或!**/*.spec.ts：显式排除测试文件（别依赖.gitignore，有些项目 test 在 src 里） -
!node_modules/**,!dist/**,!build/**：多个排除项用英文逗号分隔，VSCode 会逐个过滤 - 组合使用：
src/features/auth/**/*.{ts,js}表示只在认证模块下搜 JS/TS 文件
用正则 + 全词匹配守住语义边界
安全重构的关键是让搜索结果只命中你“想动”的那部分代码。光靠字符串太危险，得靠正则和开关收口。
- 勾选
Match Whole Word（ab图标）：避免handleUser搜出handleUserLogin；但注意它对驼峰无效，此时必须上正则 - 启用
Use Regular Expression（.*图标），用\bgetUser\b匹配单词边界，\b能识别驼峰中的get和User是两个词 - 调用场景更准：搜
getUser\([^)]*\)只匹配带括号的调用，排除const getUser = ...定义；反过来，搜const\s+getUser\s*=就只抓定义 - 替换时用捕获组：
getUser\(([^)]*)\)→api.user.get($1)，保留参数不变，只改调用路径
先预览、再小批量、最后才全部替换
VSCode 的 “全部替换” 没撤回按钮，Git 也救不了已提交的错误。所有重构动作必须经过三层验证。
- 点开每个搜索结果左侧的 ▶ 展开上下文，确认前后几行是否符合预期（比如是否在
if块内、是否是 mock 数据） - 选中前 2–3 个结果，右键 → “替换为”，手动验证一次效果；尤其注意引号、括号、分号是否被连带改动
- 替换后立刻运行
npm run build或npm test，而不是等 CI 报错才发现问题 - 如果项目开了 ESLint，顺手跑一遍
npx eslint . --fix，避免因格式变化触发规则报错
最常被忽略的是语言服务状态——即使你写了完美正则，如果右下角状态栏显示的是 Plain Text 而不是 TypeScript，那搜索结果就只是纯文本，无法感知 import/export、类型声明这些关键上下文。重构前务必确认文件已由对应语言服务器接管。
