VSCode重命名失效主因是语言服务未激活：先检查右下角语言模式是否正确（如Python需选Python (Pylance)），再确认项目有对应配置文件（jsconfig.json/tsconfig.json/pyproject.toml），最后验证光标位于有效标识符上且editor.rename.enable为true。
VSCode 重命名没反应，90% 不是编辑器坏了，而是语言服务压根没接管你的代码——它连变量在哪定义都找不到，自然没法改引用。
右下角语言模式显示 Plain Text 或错配？
这是最常见、也最容易忽略的起点。VS Code 的 Rename Symbol 功能只在语言服务激活时才可用，而服务是否启动，第一眼就看右下角状态栏。
- 点击右下角文字（如
Plain Text、JavaScript React、Python），手动选成对应语言：JS 项目选JavaScript，TS 项目选TypeScript，Python 项目必须选Python (Pylance)（不是仅Python） - 如果选了还是灰掉，打开命令面板（
Ctrl+Shift+P），运行Developer: Toggle Developer Tools，看 Console 里有没有No rename provider registered或Language client is not ready - Python 项目尤其要注意：装了官方
Python扩展还不够，必须启用Pylance，且状态栏明确显示Python (Pylance)
项目缺 jsconfig.json / tsconfig.json / pyproject.toml？
没有这些配置文件，语言服务只能做单文件分析，跨文件重命名必然失效——你改了 utils.js 里的函数名，main.js 里的调用纹丝不动。
- JS 项目：在项目根目录新建
jsconfig.json，至少包含：{ "include": ["**/*.js"], "exclude": ["node_modules"] } - TS 项目：确保有
tsconfig.json，且不要设"noImplicitAny": true之类导致服务启动失败的选项 - Python 项目：必须有
pyproject.toml（或pyrightconfig.json），且含基础类型检查配置，例如：[tool.pyright] typeCheckingMode = "basic"
- 改完配置后，务必运行
Developer: Restart Extension Host或重启 VS Code，否则不生效
F2 按了没弹框？检查光标位置和符号有效性
Rename Symbol 只对“可识别的符号”起作用，不是所有单词都能重命名。光标停错地方，功能直接静默退出。
- 光标不能在字符串里：
console.log("user_name")中的user_name是字面量，不可重命名 - 不能在注释中、正则表达式内、或
obj["user" + key]这类动态拼接处 - 不能停在点号后（
obj.）、括号内（func(）、或引号开头（"）——得精确落在标识符字母上 - TS/JS 中若变量类型为
any，或来自未提供类型定义的第三方库，重命名也可能跳过
扩展冲突或设置被关？
有些插件会劫持 F2 或禁用语义功能，而 editor.rename.enable 这个开关也可能被意外关闭。
- 打开设置（
Ctrl+,），搜editor.rename.enable，确认它是true - 禁用所有扩展，重启 VS Code，再试 F2；如果好了，就逐个启用排查——重点盯
Volar（Vue）、Prettier、GitLens、Path Intellisense和各类“文件增强”类插件 - 某些插件（如旧版
vscode-icons）会在重命名时吞掉 Enter 键，导致编辑框无法提交，表现为“输入完按回车没反应” - Remote-SSH 或 WSL 环境下，要确保远程端也装了对应语言服务器（如 Pylance server），本地设置不自动同步过去
真正卡住的地方往往不在“怎么按”，而在“VS Code 是否相信这段代码值得被语义分析”。配置文件、语言模式、光标落点，三者缺一不可；而一旦涉及动态访问、别名路径或跨工作区引用，就得接受人工兜底——Rename Symbol 再强，也改不了 obj[key] 里的 key 值。
