VSCode 搜索接口总扫到废弃 API 文件，是因为默认不区分接口定义与废弃存根，需用 files to include 限定 src/api/*/.ts 等真实路径，并配合 search.exclude 排除 legacy-api.ts 等废弃目录，再启用 CodeGeex 语义扫描识别 @deprecated 标记。

搜索接口时为什么总扫到废弃 API 文件

不是搜索逻辑出错，而是 VSCode 默认不区分“接口定义”和“废弃存根”，只要文件路径匹配、内容含关键词（比如 getUser），就会一并返回。尤其当你项目里混着旧版 SDK 存根、mock 实现、或第三方库的类型声明（如 node_modules/@types/xxx），这些文件本身就不该参与接口调用链分析，但默认全被搜进来了。

用 files.to.include 锁定真实接口目录

VSCode 的「在文件中替换」或「全局搜索」面板右上角有 files to include 输入框，这才是控制扫描范围的开关——它优先级高于 search.exclude，且本次有效，不污染设置。

• 只搜业务接口层：输入 src/api/**/*.ts 或 src/services/**/*.js，强制限定路径前缀
• 排除声明文件干扰：别用 *.ts，否则会扫到 node_modules/@types/react-router/index.d.ts 里的废弃路由方法
• 多目录组合：用英文逗号分隔，例如 src/api/**,src/hooks/**,src/utils/request.ts

配合 search.exclude 拦截已知废弃源

有些废弃 API 是集中维护的，比如一个 legacy-api.ts 文件，或整个 src/compat/ 目录。与其每次手动过滤，不如永久排除：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 打开工作区设置 JSON：Ctrl+Shift+P → Preferences: Open Workspace Settings (JSON)
• 添加：

  "search.exclude": {
    "**/legacy-api.ts": true,
    "**/compat/**": true,
    "**/mocks/**": true
  }

• 注意：**/compat/** 匹配所有层级下的 compat 目录，而 src/compat/** 只匹配项目根下的

用 CodeGeex 主动识别并跳过废弃调用点

单纯文本搜索无法判断 api.getUser() 是不是已被标记为 @deprecated。这时需要语义层过滤：

• 确保已启用 CodeGeex 的上下文感知：codegeex.context 设为 true
• 执行 CodeGeex: Scan Deprecated APIs，它会生成带废弃状态标记的结果列表
• 点击结果中的「Go to Definition」，直接跳转到真实接口实现，而非类型声明或 mock 文件
• 若发现某接口文件里大量函数都被标 deprecated，可临时把它加进 search.exclude，避免后续误触

真正难处理的不是怎么过滤，而是那些没加 @deprecated 注释、但实际已下线的接口——它们不会被 CodeGeex 识别，也逃不出 glob 路径匹配。这种得靠人工核对文档或抓包验证，不能全交给搜索框。

大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！