F2是最直接有效的重命名方式，但需满足三个前提：光标落在可被语言服务器识别的变量名上、文件有正确语言模式标识、项目配置支持语言服务启动。
F2 是最直接有效的重命名方式，但必须确保光标落在变量名上且该变量可被语言服务器识别。
为什么有时按 F2 没反应？
常见错误现象：F2 按下后无任何提示或报错，变量名也没变——大概率是当前文件没被语言服务支持，或者变量作用域太模糊（比如未声明类型、在字符串里、或被 eval 动态引用）。
- 检查右下角状态栏：确认显示了正确的语言模式（如
TypeScript、Python、JavaScript），不是Plain Text - 确保已安装对应语言扩展（如
Python扩展对.py文件启用rename支持） - 变量需有明确声明：例如
let count = 0可重命名；而obj["count"]或console.log("count")中的count不会触发重命名
重命名时如何避免改错地方？
VSCode 的重命名默认只修改「当前作用域内」的引用，但实际行为受语言服务器控制。例如在 TypeScript 中，const foo = 1 的 foo 会被整个文件内所有同名绑定识别；但在 JavaScript 中若没启用 javascript.suggest.autoImports 或 typescript.preferences.includePackageJsonAutoImports，可能漏掉导入/导出别名。
- 重命名前先用
Ctrl+Click（Mac 为Cmd+Click）点一下变量，看是否能跳转到定义——跳不到，基本重命名也无效 - 如果变量来自解构（如
const { name } = user），重命名name默认只影响该解构语句，不改user.name——这是预期行为，不是 bug - 想跨文件重命名？确保项目有
tsconfig.json（TS）或jsconfig.json（JS），否则语言服务无法建立完整符号链接
命令面板里找 rename symbol 总是慢半拍？
手动打开命令面板（Ctrl+Shift+P）再输入 rename symbol 虽然可行，但延迟高、路径长，还容易误选成 change all occurrences 这类文本替换命令。
- 文本替换（
Ctrl+H→Alt+Enter全选当前词）只是字符串替换，不校验作用域，极可能破坏代码逻辑 - 如果
F2失效，优先检查语言服务状态（查看输出面板 → 切换到TypeScript或对应语言日志），而不是退而求其次用全局替换 - 部分语言（如
Go）需额外配置"go.toolsManagement.autoUpdate": true才能让gopls正确提供重命名支持
真正卡住的地方往往不是快捷键记不住，而是变量没被语言服务“看见”——光标停对位置、文件有正确语言标识、项目配置能启动语言服务器，这三步缺一不可。
