vscode无法通过f12/shift+f12识别“已废弃的常量”，因其仅索引语法声明与调用关系，不解析jsdoc等语义标记；需依赖语言服务器配置、标准注释、eslint规则及全局搜索配合人工判断。
为什么“已废弃的常量”在 VSCode 里查不到定义或引用
VSCode 的 F12 和 Shift+F12 无法识别“已废弃”本身——它不是语法结构，而是语义标记（比如 JSDoc @deprecated 或 TypeScript 的 declare const XXX: any & { __deprecated: true }）。语言服务器只索引声明和调用关系，不解析注释含义。所以你按 F12 能跳到定义，但不会高亮“这玩意儿废了”；Shift+F12 查引用也照常工作，哪怕该常量已被标记为废弃。
怎么让 VSCode 主动标出废弃常量
靠语言服务器自动提示，而非手动翻代码：
- JavaScript/TypeScript 项目必须启用
jsconfig.json或tsconfig.json，且确保"compilerOptions": { "allowJs": true, "checkJs": true }（JS 文件需类型检查才读 JSDoc） - 在常量定义上方加标准 JSDoc：
/** * @deprecated Use NEW_CONFIG instead */ export const OLD_TIMEOUT = 5000;
- TypeScript 用户可配合
typescript-eslint规则deprecation，在 ESLint 面板中标红废弃调用（注意：只标“谁还在用”，不标“定义本身已废”） - Python 用户需用
pyright或Pylance+# type: ignore[deprecated]注释，但 Pylance 对@deprecated支持有限，更推荐在 docstring 里写明并靠人工巡检
Ctrl+Shift+F 搜废弃线索时容易漏掉的关键点
全局文本搜索仍是最快兜底手段，但默认设置会漏关键信息：
- 必须勾选
Match Whole Word：否则搜deprecated会命中deprecation、deprecatedFlag等干扰项 - 开启正则模式，搜
@deprecated\b或#.*deprecated（Python 注释），避免漏掉换行后的注释块 - 排除
node_modules和dist目录——这些目录里的废弃标记是第三方库的，跟你无关 - 重点扫
.d.ts类型声明文件：很多废弃常量只在类型层标记，源码里根本没写@deprecated，但declare const行上方有注释
真正难定位的废弃常量长什么样
它们往往绕过所有静态分析，只靠运行时逻辑“悄悄退役”：
-
const API_VERSION = process.env.NODE_ENV === 'prod' ? 'v1' : 'v2';—— 常量值动态决定，F12跳得到，但没人知道v1其实已停服 - Webpack DefinePlugin 注入的常量：
new webpack.DefinePlugin({ __DEPRECATED__: JSON.stringify(true) })—— 不出现在源码，Ctrl+Shift+F搜不到，只能看构建配置 - Vue 或 React 组件里硬编码的字符串：
if (mode === 'legacy') { ... }——legacy是魔数，不是常量名，连定义都没有 - 环境变量映射常量：
const TIMEOUT = parseInt(process.env.TIMEOUT_MS || '3000');—— 废弃与否取决于部署时的 env，VSCode 根本无从判断
这类情况没有银弹，得结合 CI 日志、监控告警、Git Blame 看谁 last modified 了相关调用链，再反推常量是否实质废弃。
