F2重命名依赖语言服务器语义分析，失效主因是语言服务未就绪：状态栏语言标识异常、缺失tsconfig.json/jsconfig.json或pyproject.toml、未安装Pylance等扩展、光标位置非法，或控制台报textDocument/rename失败。
VSCode 的“重命名符号”不是文本查找替换，它依赖语言服务器做语义分析；没装对语言服务或文件没被索引，F2 就会失效或只改当前文件。
为什么 F2 按了没反应，或者只改了本文件？
最常见原因是语言服务未就绪或未激活。VSCode 不是靠正则匹配，而是靠语言服务器解析 AST 后返回引用位置——如果服务器没启动、没加载成功、或当前文件类型不被支持，textDocument/rename 请求就会失败或返回空结果。
- 检查状态栏右下角语言标识（如 “TypeScript”、“Python”），点击确认是否启用了对应语言服务
- TypeScript/JavaScript 默认带
tsserver，但需确保有tsconfig.json或jsconfig.json，否则跨文件索引可能不全 - Python 必须安装
Pylance（非仅 Python 扩展），且项目根目录建议有pyproject.toml或__init__.py以启用模块解析 - Go 需确认
gopls已安装并可执行，运行go env GOPATH后检查bin/gopls是否存在 - 打开命令面板（
Ctrl+Shift+P），输入Developer: Toggle Developer Tools，在 Console 中搜rename或failed，常能看到具体错误（如 “No definition found”）
重命名后某些引用没更新，常见于哪些场景？
语言服务能识别的引用，必须是“可静态解析”的。动态拼接、eval、字符串形式的调用、未导入的第三方符号，统统不会被纳入重命名范围。
-
obj["methodName"]()或obj[methodNameVar]()—— 属于运行时属性访问，AST 无法确定绑定目标，不会更新 -
import * as utils from "./utils"后写utils.calculateSum(1,2)，再重命名calculateSum：若utils是 namespace 导入且未显式导出，部分语言服务可能漏掉引用 - JS/TS 中使用
require("./math").add(1,2)（CommonJS）且无类型声明文件（.d.ts），add可能不被视为可重命名符号 - Vue SFC 的
<script setup>中用defineProps声明的 props 名，重命名 props 变量本身是安全的；但重命名其内部字段（如props.user.name）不会触发任何响应 —— 它不是符号定义，只是路径访问
editor.renameOnType 开了反而出问题？
这个配置让 VSCode 在你输入新名字时实时预览修改点，但它极度依赖语言服务响应速度和稳定性。开启后卡顿、崩溃或误标，往往说明当前项目规模或语言服务负载已超预期。
- 大型 monorepo（尤其含多个
tsconfig.json）开启后，tsserver可能频繁重启，导致重命名延迟甚至中断 - Python + Pylance 在未配置
"python.defaultInterpreterPath"时，renameOnType可能因解释器路径模糊而反复报错 - 临时禁用方法：在设置中搜索
renameOnType，取消勾选；或加到工作区设置里局部关闭：{ "editor.renameOnType": false } - 它不改变重命名逻辑，只影响交互方式；最终按回车确认的修改内容，与关掉该选项后手动重命名完全一致
想批量改变量名 + 对应注释/CSS 类名，F2 不够用怎么办？
F2 只管语言符号，不管字符串、注释、HTML 属性或 CSS 类名。这类跨语法域的联动，必须靠额外工具或约定驱动。
- 前端组件重命名（如 React 组件
Button→PrimaryButton）：需同步改import { Button }、<Button />、button.css中的.Button、JSDoc 里的@component Button—— 这些无法靠 LSP 自动覆盖 - 可行方案：用
ripgrep（rg）配合正则批量查改，例如rg -l '\bButton\b' --type-add 'css:*.css' --type-add 'md:*.md' | xargs sed -i 's/\bButton\b/PrimaryButton/g'
，但要人工核验上下文，避免误伤 - 更稳妥的是约定优先：CSS 类名用 BEM（如
button--primary），组件名与类名解耦；文档用自动化生成（如 TypeDoc），减少手写注释中的硬编码名称 - 插件如
multi-command可串联F2+ 查找替换，但无法保证语义安全，仅适合可控小范围
真正容易被忽略的点是：重命名是否生效，不取决于你按了多少次 F2，而取决于语言服务能否构建出完整的符号图。一个没被 import 或 require 进来的文件，哪怕物理上在项目里，也不会出现在引用列表中。
