F2是VSCode全局重命名的正确入口，但需语言服务就绪、光标在有效标识符上、项目配置正确且扩展正常；否则退化为文本替换或失效，字符串拼接、any类型、JSX未声明属性等场景F2完全不处理。
F2 是全局重命名的正确入口，但按了没反应或只改局部，基本不是快捷键问题，而是语言服务没就绪或符号未被识别。
为什么 F2 按下后没反应或只改当前文件
VSCode 的 F2 不是文本替换，它调用的是语言服务器（LSP）做语义分析。以下任一条件不满足，F2 就会退化为简单文本替换，甚至完全失效：
- 右下角状态栏显示的是
Plain Text或错误语言模式（比如该是TypeScript却显示JavaScript） - 光标没完整落在标识符上（例如停在
userName的末尾空格、引号内、或点号后） - 项目根目录缺少必要配置文件：
tsconfig.json（TS/JS）、pyproject.toml（Python）、jsconfig.json（JS） - 对应语言扩展未启用或异常：Python 必须用
Pylance，不能只靠旧版Python扩展；TS/JS 依赖内置支持，但需配置文件触发索引 - 按
Ctrl+Click无法跳转到其他引用——说明 LSP 还没建好跨文件关系，此时F2一定不会更新其他文件
哪些地方 F2 绝对不会改，必须手动搜
语言服务器只处理静态可推导的引用。以下情况 F2 从不触碰，也不会警告你遗漏：
-
obj["user" + "Name"]—— 字符串拼接，键名无法静态分析 -
const key = "userName"; obj[key]—— 属性名来自变量 -
const x: any = {}; x.userName—— TypeScript 中any类型绕过类型检查 -
<usercard username="x"></usercard>—— JSX 属性若未在组件定义中声明userNameprop，就不算符号引用 -
console.log("user_name not found")—— 日志里的硬编码字符串
这些只能靠 Ctrl+Shift+F 全局搜索确认，尤其改公共 API 名称时，漏一个可能引发线上报错。
如何安全执行一次跨文件重命名
重命名前不验证上下文，等于直接往生产环境发 patch。关键动作不是按 F2，而是确认三件事：
- 先保存所有相关文件（
Ctrl+S），避免 LSP 读取缓存旧内容 - 确保导出方式规范：用
export function foo()，别用export default function()（后者重命名后可能丢失类型） - 导入方式匹配：调用方必须是具名 import（
import { foo } from './utils'），而非import utils from './utils'; utils.foo - 重命名后立刻看底部弹出的
Preview changes窗口——它列出所有将被修改的位置，**必须点开逐个检查**，重点核对是否混入了字符串或模板字面量 - 改完立刻运行
git status和git diff，扫一眼变更范围，特别注意 JSON、.env、HTML 模板里是否被连带误改
别信 Ctrl+Shift+R 能重命名
Ctrl+Shift+R 在原生 VSCode 中是未绑定的（undefined）。如果你按了有反应，大概率是某个扩展（如 Auto Rename Tag 或 Python 扩展）偷偷占用了它。它不会触发重命名、提取变量或函数。
真想用这个组合键打开重构菜单，得手动绑定：
- 打开快捷键设置：
Ctrl+K Ctrl+S - 搜索
editor.action.refactor - 双击该条目，按
Ctrl+Shift+R确认绑定 - 务必加上
when条件：editorHasCodeActionsProvider && editorTextFocus，否则在不可重构位置也会弹窗
注意：editor.action.refactor 只弹菜单，不自动执行；真正可用的细粒度操作仍是 Ctrl+.（灯泡）、Ctrl+K Ctrl+X（提取变量）、Ctrl+K Ctrl+M（提取函数）。
重命名这件事，最耗时间的从来不是按键动作，而是判断“哪里该改、哪里不该动、改完有没有副作用”。语言服务器能帮你省掉 70% 的机械劳动，但剩下那 30% 的边界 case，得靠你盯着 Ctrl+Shift+F 的结果一行行过。
