F2用于语义重命名，仅修改标识符的真正引用；Ctrl+H/Ctrl+Shift+H为文本替换，易误改字符串和注释。F2生效需语言模式正确、光标在声明处、项目有tsconfig.json等配置；文本替换须严格启用全字匹配与预览确认。
VSCode 里“批量查找并重命名代码”不是单一操作，而是两条完全不同的技术路径：语义重命名（推荐）走 F2，文本替换（谨慎）走 Ctrl+H 或 Ctrl+Shift+H。选错路径，轻则漏改，重则污染字符串和注释。
什么时候该用 F2 重命名而不是查找替换
当你修改的是一个**有明确作用域和语义的标识符**——比如函数名、变量声明、类名、导出名，且希望只改所有“真正引用它”的地方（不碰字符串、注释、JSON key、正则字面量等）。
- 必须满足：文件被正确识别为对应语言（右下角显示
TypeScript、JavaScript、Python等，不能是Plain Text） - 光标必须停在该标识符的**声明位置**（如
function foo() {中的foo），而非调用处或字符串内 - 项目根目录需有
tsconfig.json（TS）或jsconfig.json（JS），否则跨文件引用无法识别 - 如果按
F2后没反应或只改了当前文件，大概率是语言服务没加载，不是快捷键失效
为什么 Ctrl+H 全局替换容易出事
它做的是纯文本匹配，不管上下文。比如把 data 替成 payload，会同时改掉 const data = {};、console.log("user data");、obj["data"] 甚至 JSON.parse('{"data":1}') —— 这些都不是语义引用，但全被替了。
- 短名称（
i、err、res）风险最高，几乎必然误伤 - 正则模式开启后（点击
.*图标），(err)可缓解但不解决根本问题：它仍无法区分catch(err)和"error: " + err.message - 若必须用
Ctrl+H，务必勾选Match Case和Whole Word，再预览所有匹配项（别跳过！）
Ctrl+Shift+H 全局搜索替换的实操要点
适用于结构清晰、上下文可控的批量文本修正，比如统一 API 路径前缀、日志函数迁移、模板字符串中固定占位符替换。
- 打开方式：
Ctrl+Shift+H（Windows/Linux）或Cmd+Shift+H（macOS） - 限定范围更安全：在搜索框下方点
files to include，填src/**/*.ts或排除node_modules/** - 正则示例：把
api/v1/users改成api/v2/users，查找api/v1/users，替换为api/v2/users；若含转义，用api\/v1\/users - 替换前一定点开右侧小箭头展开预览，确认每一条都是你想要改的——VSCode 不会帮你判断逻辑对错
容易被忽略的边界情况
即使 F2 语义重命名成功，也有几类地方它天然不处理，得人工核对：
- 动态属性访问：
obj[variableName]中的variableName值不会变，obj上的 key 更不会自动更新 - 字符串拼接：
`/api/${endpoint}`里的endpoint会被重命名，但拼出来的路径字符串内容不变 - eval / new Function / 模板字符串内执行的代码，静态分析无法覆盖
- import 绑定名可重命名，但源文件中的原始导出名必须去源文件单独改——移动文件后 import 路径不会自动修复
