vscode全局替换易误伤注释和字符串，应启用正则与全词匹配；跨文件重构需配置search.exclude；ts项目优先用f2语义重命名；批量改import用正则捕获组更安全；隐性依赖须人工核对。
全局替换会误伤注释和字符串里的内容
VSCode 默认的 Ctrl+Shift+H（Windows/Linux）或 Cmd+Shift+H（macOS）全局替换，对正则和上下文不敏感。它会无差别匹配所有文本——包括注释里的 console.log、JSON 字符串里的 "name": "user"、甚至被引号包裹的变量名 "userId"。这类误替换轻则导致语法错误，重则让代码逻辑悄悄失效。
安全做法是先启用「使用正则表达式」和「匹配整个单词」两个开关：
- 点击搜索框右侧的
.*图标启用正则模式 - 点击
\b图标（或按Alt+\）开启“全词匹配”——这能避开user匹配到username的问题 - 若目标是函数调用（如把
getUser()改成fetchUser()），正则写成\bgetUser\(\)，括号必须转义
跨文件重构时，search.exclude 比手动勾选更可靠
你可能习惯在搜索面板里点「…」排除 node_modules 或 dist，但这个操作只对当前搜索生效，下次打开又得重来。更稳的方式是配置工作区级别的排除规则。
在项目根目录的 .vscode/settings.json 中添加：
{
"search.exclude": {
"**/node_modules": true,
"**/dist": true,
"**/build": true,
"**/*.min.js": true
}
}
这样每次全局搜索都自动跳过这些路径。注意：如果用了符号链接（比如 ln -s），VSCode 可能仍会扫描进去，此时需额外加 "**/symlinks/**": true。
改函数名别只靠文本替换，优先用 TS 的重命名功能
纯文本替换 getUser → fetchUser 在 TypeScript 项目里极危险：它不会更新类型定义、不会检查重载签名、也不会识别泛型参数中的同名标识符（比如 getUser<t>()</t> 里的 T 不受影响，但调用处可能漏改）。
正确姿势是把光标停在函数名上，按 F2 触发语义化重命名：
- 仅当文件有有效 TS 类型检查（即
tsconfig.json存在且未报错）时才可用 - 它会跨文件分析引用，包括 import/export、JSDoc @param 类型、甚至 Vue SFC 的
<script setup></script>中的解构 - 如果提示 “No references found”，先检查是否打开了
typescript.preferences.includePackageJsonAutoImports
批量改 import 路径时，正则捕获组比手敲更少出错
比如要把所有 import { foo } from './utils' 改成 import { foo } from '@/utils'，手动输容易漏掉空格、引号或大括号外的空行。用正则一次到位更稳妥：
搜索：import\s+({[^}]+})\s+from\s+['"](\./[^'"]+)['"]
替换：import $1 from '@/utils'
关键点：
- 第一个捕获组
({[^}]+})精确提取大括号内内容（避免匹配到嵌套对象） - 第二个捕获组
(\./[^'"]+)匹配相对路径，但不贪婪到引号外 - 替换时用
$1引用原内容，确保只有路径部分被换掉 - 务必先点「预览」看所有匹配项，确认没有意外命中
import type或export * from
真正麻烦的不是替换动作本身，而是那些没出现在搜索结果里的“隐性依赖”——比如通过 eval 拼接的字符串路径、Webpack 的 require.context 动态导入、或者 Babel 插件生成的代码。这类地方只能靠 grep + 人工核对，别信任何编辑器的“全项目搜索”能覆盖全部。
