F2重命名并非总是安全，其可靠性取决于语言服务状态：若LSP未就绪、配置缺失（如tsconfig.json或pyproject.toml）、导入方式不被AST支持（如动态import或字符串索引），或符号定义作用域受限（如IIFE内函数），则可能仅局部修改甚至失效。
F2 重命名是否总是安全？先看语言服务状态
VSCode 的 F2 不是万能文本替换，它依赖语言服务器（LSP）实时解析 AST 和符号表。如果语言服务没就绪、报错或未加载，F2 可能只改当前文件，甚至提示“无法重命名为此符号”。
- 打开命令面板（
Ctrl+Shift+P），输入Developer: Toggle Developer Tools，查看 Console 是否有Language Server crashed或Failed to start报错 - TypeScript/JavaScript 项目需确保
tsconfig.json存在且"include"覆盖所有源码目录；否则mathUtils.ts里的calculateSum在main.ts中可能不被识别为可重命名符号 - Python 项目必须安装并启用
Pylance（非仅 Python 扩展），否则rename_symbol请求会返回空结果
跨文件引用漏改？检查模块导入方式是否被静态分析支持
重命名失败最常见于动态或非标准导入场景——语言服务器靠 AST 分析，不是正则匹配。
-
import * as utils from './utils'+utils.calculateSum()：重命名calculateSum时，utils是 namespace，calculateSum的引用可能不被识别（TypeScript 默认关闭allowSyntheticDefaultImports时更易出问题） -
require('./utils')['calculateSum']()或obj['methodName']()：这类字符串索引完全逃逸静态分析，F2不会触碰 - ES6 动态导入
const mod = await import('./utils')：目前主流 LSP（如 TypeScript Server）不追踪此类运行时导入的符号引用
快捷键行为不一致？别混淆 Rename Symbol 和其他重命名操作
F2 绑定的是 editor.action.rename，但某些插件或自定义快捷键会覆盖它，导致“按了没反应”或“只改当前行”。
- 在命令面板中执行
Preferences: Open Keyboard Shortcuts，搜索rename，确认editor.action.rename确实绑定到F2，且无冲突项（比如某 Git 插件也绑了F2） - 右键菜单里“重命名符号”和“重命名文件”是两个不同命令：
editor.action.renamevsexplorer.rename，后者只改文件名，不碰代码内引用 - Mac 用户注意：部分外接键盘需在系统设置中启用“使用 F1、F2 等键作为标准功能键”，否则
F2可能触发音量调节而非重命名
重构后依赖引用没更新？重点排查作用域与导出声明
即使语言服务正常，重命名仍可能“半途而废”——根源常在符号定义本身是否被正确导出/导入。
- 函数定义在
if块或 IIFE 内部（如(function(){ function foo(){} })()）：LSP 通常不将其视为可导出符号，F2无法跨文件追踪 - TypeScript 中
export default function foo()重命名为bar后，导入侧import foo from './x'不会自动改为bar—— 因为 default 导入名是别名，不是符号引用 - Vue SFC 或 JSX 中，
class="user-card"这类字符串值不会被F2触及，哪怕变量名已改；这是设计使然，不是 bug
重命名的可靠性不取决于快捷键是否按下，而取决于符号能否被语言服务器在语义层“看见”。一个看似简单的 F2，背后是 AST 解析、作用域链遍历、跨文件索引和导出图构建的完整链条——任何一环断开，都会让引用变更停留在表面。
