F2是VSCode中语义级重命名的唯一可靠快捷键，F12和Ctrl+Click仅用于跳转验证；Ctrl+Shift+R默认无功能，重构需用Ctrl+.唤出菜单或Ctrl+K Ctrl+M/X等上下文快捷键；跨文件重命名依赖tsconfig.json或pyproject.toml配置及语言服务器重启。
F2 是重命名变量唯一可靠快捷键，不是 F12 或 Ctrl+Click
按 F2 才是语义级重命名的正确入口；F12（跳转定义）和 Ctrl+Click 只是验证手段，不能触发修改。很多人误点右键菜单里的“Rename Symbol”，结果在某些语言或配置下失效——F2 才是 VSCode 官方绑定、语言服务器直连的唯一稳定路径。
常见错误现象：F2 按下后弹窗一闪而过、光标直接跳走、或根本没弹出输入框——这说明语言服务未接管该符号，不是快捷键坏了。
- 确认右下角状态栏显示的是
Python/TypeScript/JavaScript，而非Plain Text - 光标必须落在变量声明处（如
const userName中的userName）或显式引用处（如console.log(userName)），不能停在"userName"字符串里 - 按
Ctrl+Click能跳转到定义，才是F2可用的前提
Ctrl+Shift+R 不是重构快捷键，它默认不绑定任何命令
Ctrl+Shift+R 在原生 VSCode 中是空操作，既不触发重命名，也不提取函数——你按了没反应，不是配置错，是它本来就没被定义。网上流传的“VSCode 用 Ctrl+Shift+R 提取函数”说法，混淆了旧版插件行为或个别扩展的自定义绑定。
真正可用的重构快捷键是分散且上下文敏感的：
- 唤出重构菜单：
Ctrl+.（Windows/Linux）或Cmd+.（macOS），光标需落在函数名、变量名或选中代码块上 - 提取为函数：
Ctrl+K Ctrl+M（JS/TS 默认启用；Python 需 Pylance + 正确pyproject.toml） - 提取为变量：
Ctrl+K Ctrl+X，仅对可推断类型的表达式有效（如a + b * 2）
重命名后 import 行不变？这是设计，不是 bug
当你对 from api import get_user 中的 get_user 按 F2，VSCode 默认只改当前文件内所有对该导入名的使用，不会动 api.py 里的 def get_user()，也不会更新其他文件的 import 行。这不是漏改，而是语义隔离：导入名和定义名是两个独立符号。
想同步改定义和所有导入，必须满足两个条件：
- 目标函数需具名导出（
export function get_user()），而非export default function() - 调用方必须用具名导入（
import { get_user }），不能用import api from 'api'; api.get_user()
否则语言服务器无法建立跨文件符号映射，F2 就只能做局部文本替换。
跨文件重命名失效？先检查 tsconfig.json 或 pyproject.toml
没有 tsconfig.json（TS/JS）或 pyproject.toml（Python），语言服务就降级为单文件模式——F2 在 A.ts 里重命名一个函数，不会更新 B.ts 里的调用，也不会改 import 行。这不是性能问题，是符号图根本没构建出来。
关键配置项：
- TypeScript：项目根目录必须有
tsconfig.json，哪怕只有{}也比没有强 - Python：需含
[tool.pylance]或[tool.pyright]块；若代码在src/下，还得加extraPaths = ["src"] - 验证方式：打开 Output 面板 → 切换到
Pylance或TypeScript日志，搜Failed to resolve import
最常被忽略的是：改完配置后没重启语言服务器——关掉 VSCode 再重开，或者命令面板运行 Developer: Restart Language Server。
