VSCode无项目级批量重命名功能，F2仅支持语义化单符号重命名，Ctrl+Shift+H需配合文件过滤、大小写与全字匹配及正则才能安全兜底。
VSCode 里没有“项目级脚本化批量重命名”的快捷键或内置命令——editor.action.rename（即 F2）只作用于当前光标下的单个符号，不能传参、不能批处理多个不同变量名；而全局字符串替换（Ctrl+Shift+H）不理解语义，会误改注释、字符串字面量、JSON 键、CSS 类名等非代码逻辑位置。
为什么直接按 F2 有时只改了当前行？
因为 F2 依赖语言服务识别“这是一个被声明的、可追踪的符号”。常见失效场景包括：
- 文件右下角语言模式显示为
Plain Text或JavaScript React（而非TypeScript），导致语言服务器未加载 - 变量是隐式全局（如直接写
myVar = 123），没用let/const/var声明，语言服务无法绑定引用 - TS 文件中类型缺失（如大量
any）、tsconfig.json路径未覆盖源码目录，导致符号图构建不全 - 光标停在字符串内（如
"myVar"）、JSX 属性（如className="myVar"）或对象字面量键（如{ myVar: 1 }）上，这些不是可重命名的“标识符”
Ctrl+Shift+H 全局替换必须加这三项过滤
纯字符串替换虽危险，但加上精准约束后，能安全处理大量重构场景（比如统一改前缀、删后缀、函数调用签名调整）。关键不是“能不能用”，而是“怎么限得准”：
- 在
包含文件框中填**/*.ts（或**/*.js、**/*.php），避免污染node_modules、dist、.git等目录 - 勾选
Aa（区分大小写）：防止把USER_ID和userId同时替换成同一个新名 - 勾选
ab（全字匹配）：避免把fetchUser中的user单独替换成profile，变成fetchProfile
正则替换才能处理驼峰/连字符类名迁移
比如要把 get_user_data 改成 getUserData，或把 .old-component 改成 .new-component，必须用正则捕获组：
- 搜索：
get_([a-z]+)_([a-z]+)→ 替换：get$1$2（注意：VSCode 正则中捕获组引用用$1，不是\1） - 搜索：
\.old-comp-([a-zA-Z0-9_-]+)→ 替换：.new-comp-$1 - 搜索：
function\s+([a-zA-Z0-9_]+)\s*\(\)→ 替换：function $1Async()（给所有无参函数加Async后缀）
务必先点 .* 图标启用正则，再逐个预览匹配项——VSCode 不会高亮捕获组范围，容易写错括号或漏转义。
真正安全的“项目重命名”只有两步闭环
所有可靠的大规模重命名，都得靠“语义重命名 + 字符串兜底”组合拳：
- 第一步：对每个要改的符号，手动把光标停在声明处（如
const oldName = ...），按F2改名 → VSCode 自动更新所有语义引用（函数调用、import、class 成员等） - 第二步：用
Ctrl+Shift+H配合ab+Aa+**/*.ts，扫一遍剩余非语义位置（如日志字符串"oldName not found"、测试用例里的 mock 数据）并人工确认
跳过第一步直接全局替换，等于拿手术刀切豆腐——看着快，但切到血管（逻辑错误）的概率极高；而只信 F2 又会漏掉那些语言服务管不到的角落。真正麻烦的从来不是操作本身，而是判断“这个字符串到底算不算一个符号”。
