vscode intellisense 显示废弃方法的根本原因是类型定义未标注@deprecated、语言服务器未启用弃用过滤或使用过时类型包；关键解决项是设置"editor.suggest.showdeprecated": false，并更新对应@types包及语言服务器版本。
VSCode 的 IntelliSense 里出现废弃方法（如 document.write、Array.observe 或已弃用的库 API），不是提示“太全”，而是类型定义没过滤、语言服务器没识别弃用标记（@deprecated）或你正用着过时的类型声明包。
为什么 deprecated 方法还会出现在补全列表里
VSCode 本身不判断“废弃”，它只把语言服务器（如 TypeScript Server、Pyright、Rust Analyzer）提供的符号原样展示。而是否隐藏带 @deprecated 标签的方法，取决于三件事：
- 所用的类型定义（
.d.ts文件）是否真写了@deprecated注释——很多旧版 DefinitelyTyped 包没加，或只写在 JSDoc 里但没用标准标签 - 语言服务器是否启用弃用过滤：TypeScript 默认开启，但需
"typescript.preferences.includePackageJsonAutoImports": "auto"等配合；Python 的 Pylance 需"python.analysis.typeCheckingMode": "basic"才严格读取@deprecated - 你本地装的是不是最新版类型包：比如
@types/react18.2+ 才给findDOMNode加了弃用标记，旧版不会过滤
手动过滤废弃 API 的关键配置项
不要指望 GUI 设置界面能调出“隐藏 deprecated”开关——它藏在 settings.json 里，且因语言而异：
- TypeScript/JavaScript：
"typescript.suggest.classMemberSnippets.enabled": false（关掉类成员自动展开，减少冗余） + 确保"javascript.suggest.autoImports": true，让新 API 优先被索引 - Python：
"python.analysis.extraPaths": ["./typings"]，把自定义的、已清理过弃用项的 stubs 放进去；同时禁用"python.languageServer": "Jedi"（Jedi 不识别@deprecated） - 全局压制干扰源：
"editor.suggest.showDeprecated": false—— 这是唯一真正起效的通用开关，设为false后，所有带弃用标记的项直接不出现在列表里（注意：不是灰掉，是彻底不显示）
检查并更新类型定义源头
补全列表里的垃圾，往往来自你没意识到正在引用的类型包。快速定位方法：
- 在代码中右键点击一个废弃方法（如
XMLHttpRequest.open），选“转到类型定义”——看跳转路径是不是指向lib.dom.d.ts或某个@types/xxx包 - 如果是
lib.dom.d.ts，说明是 TS 内置 DOM 库，升级 VSCode 和 TypeScript 插件即可（2026 年 5 月起新版已移除大量已废 API） - 如果是
@types/lodash这类第三方包，运行npm outdated @types/lodash，再npm install @types/lodash@latest；旧版常保留_.pluck这种已被删的别名
容易被忽略的兼容性陷阱
即使你配了 "editor.suggest.showDeprecated": false，以下情况仍会漏出废弃项：
- 你在 JS 文件里没配
jsconfig.json，TS Server 就不会加载完整类型上下文，@deprecated标记直接被忽略 - 用了
// @ts-ignore抑制报错的地方，补全也会绕过弃用检查 - Rust Analyzer 当前（2026.05）对
#[deprecated]的支持仍不稳定，某些 crate 的废弃函数会在.后弹出，需手动升级rust-analyzer到 v2026.5.15+
最硬核的过滤方式其实是删掉不用的类型包——node_modules/@types 下多出来的包，比任何配置都更容易让废弃 API 潜入补全列表。
