F2能自动检查依赖一致性是因为它调用语言服务器的textDocument/rename请求，基于AST和符号表进行语义分析，排除字符串、注释、动态访问等无效引用，并在校验失败时明确提示未更新位置。
F2 是唯一能同时完成符号重命名 + 依赖一致性校验的操作入口，其他快捷键（如 Ctrl+Shift+L）不参与语义分析，也不校验 import、类型定义或跨文件引用关系。
为什么 F2 按下后会自动检查依赖一致性
VSCode 的 F2 触发的是语言服务器协议（LSP）的 textDocument/rename 请求，不是文本替换。语言服务器会构建 AST 和符号表，逐个验证每个引用是否属于该符号的有效绑定——比如排除字符串中出现的同名子串、注释里的拼写、动态属性访问（obj[variableName]）、eval 或模板字面量拼接等无法静态推导的场景。
校验失败时，VSCode 不会静默跳过，而是明确提示：Some references were not updated，并高亮列出未被覆盖的位置。
- 仅当所有引用都通过语义解析，才会执行批量修改
- 若项目缺失
tsconfig.json或jsconfig.json，TypeScript/JavaScript 语言服务降级为词法匹配，校验能力大幅削弱 - Python 必须启用 Pylance（而非基础 Python 扩展），否则
F2对类方法、模块导入的校验会漏掉继承链或相对导入路径
F2 失效时的三类典型表现及对应修复
遇到 F2 不预览引用、只改当前文件、或直接弹出“无法重命名”提示，大概率是以下其一：
-
Plain Text语言模式：右下角状态栏显示 “Plain Text”，需点击切换为对应语言（如TypeScript、Python） - 文件位于
node_modules或dist目录：VSCode 默认禁用这些路径的语言服务，即使手动打开也不触发 LSP - 工作区未打开根目录：跨文件引用依赖项目级配置，多文件夹工作区若未以含
tsconfig.json的目录为根，符号表无法完整构建
Ctrl+Shift+L 和 F2 的本质区别不能靠记忆，得看右下角状态栏
按下 Ctrl+Shift+L 前，先确认光标选中的内容是否被 VSCode 识别为“符号”：如果右下角显示匹配数（如 7 matches），说明它在做纯文本匹配；如果显示 1 symbol 或根本没数字，说明当前上下文不支持语义识别——此时按 F2 也无效，得先解决语言服务问题。
-
Ctrl+Shift+L从不检查import语句是否需要同步更新，也不会调整解构赋值（const { foo } = obj）中的字段名 -
F2修改calculateTotal后，import { calculateTotal } from './math'和export function calculateTotal()会一并修正 - 带点号的路径（如
utils.date.format）用Ctrl+Shift+L极易误伤，而F2只作用于被声明为函数/变量的那个format
真正影响一致性校验结果的，是 tsconfig.json 里这三项
哪怕语法正确，若 tsconfig.json 关键项关闭，F2 就会退化为局部重命名：
-
"skipLibCheck": true—— 不校验 node_modules 中类型的引用，跨包重命名可能漏改 -
"composite": false—— 多项目引用（如 monorepo 中的 project references）无法联动更新 -
"allowSyntheticDefaultImports": false—— 对 CJS 模块的默认导入（import React from 'react'）重命名时，可能忽略命名空间内成员
复杂点在于：这些配置项不会让 F2 报错，而是悄悄降低校验精度——你得靠 Shift+F12 查引用数量是否与预期一致，才能发现漏掉了哪些文件。
