VSCode 中安全批量改变量名只能用 F2 重命名，依赖语言服务语义分析；Ctrl+Shift+H 是纯文本替换，无法识别作用域、类型或上下文，易误伤。
VSCode 本身没有“全局替换变量名”的独立功能，真正能安全批量改变量名的只有 F2（重命名），它依赖语言服务做语义分析；所有基于文本的全局查找替换（Ctrl+Shift+H）都只是字符串匹配，不识别作用域、类型或引用关系，强行用会出错。
为什么不能直接用 Ctrl+Shift+H 替换变量名
文本替换无法区分以下情况，极易误伤：
-
userId出现在const userId = 123（声明）、user.userId（属性访问）、"userId"（字符串）、// userId（注释）中——全部被一视同仁替换 - 大小写敏感问题：关闭
Aa时，UserID和userid都会被userId匹配到 - 单词边界失控：搜索
id会命中userId、adminId、identity，即使勾了ab（全字匹配），也无法避免id在对象属性中被孤立匹配 - TS/JS 中未显式声明的变量（如直接赋值
foo = 42）不会被语言服务索引，F2失效，但文本替换照常执行，反而更危险
F2 重命名生效的前提条件
按 F2 后只改当前处？说明语言服务没识别成功。必须满足：
- 右下角语言模式显示为
TypeScript或JavaScript（不是Plain Text或JavaScript React） - 项目根目录存在有效的
tsconfig.json（TS）或jsconfig.json（JS），且include覆盖源码路径 - 光标精确停在变量声明处（比如
const <strong>userName</strong> = 'x'中的userName上），双击选中再按F2，不要拖选或点在等号后 - 能用
Ctrl+Click（Win/Linux）跳转到定义——跳不到，F2就不可靠 - 变量不是
any类型对象上的属性（const x: any = {}; x.userName不会被追踪）
什么时候才该用 Ctrl+Shift+H 做变量名文本替换
仅限明确可控、无歧义的场景，且必须配合范围限定和预览：
- 重构前统一前缀/后缀：如把所有
myComponent→MyComponent，且确认项目中不存在myComponentName这类嵌套词 - 替换已废弃的常量名（全大写+下划线），如
MAX_RETRY_COUNT→MAX_RETRY_ATTEMPTS，这类命名冲突概率低 - Vue 模板中硬编码的 prop 名：
files to include填*.vue，搜索:user-id=→:user-name=，注意转义点号和等号 - 必须启用
Aa（区分大小写）+ab（全字匹配），并在files to include中填*.ts或src/**/*.ts，排除node_modules和dist
正则替换变量结构（非变量名）的实用技巧
想改的是“调用形式”或“结构”，不是变量名本身，这时正则才真正有用：
- 把
console.log(msg)改成logger.info(msg)： 查找：console\.log$$([^)]+)$$替换：logger.info($1)注意.和()要转义 - 把
my_function_name转驼峰：my_(\w+)→my$1（简单版），或更准的_(\w)→$1（需多次运行） - 批量加前缀：
(user|item|data)(\d+)→legacy_$1$2，前提是这些词在代码中不作为子串出现 - 所有
Log.info("xxx")改成结构化日志：Log\.info$$"([^"]+)"$$→logger.info({ message: "$1" })
最易被忽略的一点：无论用 F2 还是 Ctrl+Shift+H，只要涉及跨文件修改，务必先提交 Git 快照；替换后立刻看 git diff，重点检查是否误改了 JSON 文件、mock 数据、HTML 字符串或注释里的“假变量名”。
