shift+f12显示的“无用引用”实为静态分析结果，如jsx事件绑定、类型注解、装饰器等合法但非运行时调用的引用；真正危险的是查不到却实际依赖的动态引用，需结合全局搜索和运行时验证判断是否可删。
VSCode 本身不“排除”符号引用，它只显示语言服务器能分析出的引用；所谓“无用引用”，其实是你误判了引用关系，或语言服务没建模出来。
为什么 Shift+F12 显示的引用看起来“无用”
Shift+F12（Find All References）返回的是静态分析结果，不是运行时调用链。它标出的每一处，都可能是合法引用，只是你没意识到：
- JSX 中的
onClick={handleClick}被算作引用，但如果你删了handleClick，组件就崩了 -
import React from 'react'在启用了 JSX 自动转换（react-jsx）的项目里，即使没显式写React.createElement，也会被语言服务识别为“已使用” - 装饰器如
@memo、@observer或 JSDoc@param {SomeType}里的类型名，会触发对SomeType的引用标记，但它只是类型信息，不参与运行 - 动态访问如
obj[key]、Reflect.get(obj, key)、eval('foo()')—— 所有 LSP 都放弃分析，所以这些地方根本不会出现在引用列表里
哪些“未显示引用”反而更危险
真正该警惕的，是 Shift+F12 查不到、但代码实际依赖的符号：
- 通过字符串拼接导入：
import(`./pages/${route}.tsx`)→ 对应页面组件的导出名不会被索引 - 挂到全局的函数：
window.exportToCsv = () => {...}→ 没 import，也没任何静态引用 - Webpack 插件入口点、Vite 插件对象的
name或transform属性 → 仅靠 AST 无法反向追踪 - Mock 数据生成器中硬编码的字段名，比如
user: { name: faker.person.fullName() }→faker是导入了，但person和fullName不会被列为“被引用”
怎么判断一个符号是否真可删
别只信 Shift+F12，交叉验证三步走：
- 用
Ctrl+Shift+F全局搜符号名，勾选Match whole word和Match case，看有没有漏掉的字符串调用或模板绑定 - 搜
from '.\/或import.*symbolName（正则模式），确认有没有模块在导入它，哪怕只是类型导入 - 打开开发者工具（
Ctrl+Shift+P→Developer: Toggle Developer Tools），清空控制台后刷新页面，看是否抛ReferenceError: symbolName is not defined
配置层面减少“假阳性”引用提示
语言服务默认保守，宁可多标，不愿漏标。想让它更准，得补上下文：
- TS/JS 项目必须有
tsconfig.json或jsconfig.json，且include覆盖全部源码目录，否则大量引用关系断开 - 启用路径别名？在
tsconfig.json里配好baseUrl和paths，否则import { x } from '@utils'会被当成未解析 - JS 文件想让 import 更准？加 JSDoc 注解，比如
/** @type {import('./api').User} */ let user;，否则语言服务不敢删相关 import - 禁用
editor.suggest.showUnused可隐藏编辑器内未使用变量的灰色提示，但这只是视觉过滤，不影响引用分析逻辑
最常被误删的，从来不是满屏红波浪线的变量，而是那些没 import、没调用、但被构建工具或运行时环境悄悄消费的符号——它们不会出现在任何引用列表里，删了才露馅。
