全局搜索本身不提升可读性与维护性，但正确使用Ctrl+Shift+F限定范围、Ctrl+P+@跳转符号、开启Match Whole Word/Match Case及合理配置search.exclude，能显著降低认知负担，精准定位职责实现位置。
全局搜索本身不提高可读性或维护性，但用对方式能大幅减少“猜路径、翻文件、硬记结构”的认知负担——这才是提升可读性与维护性的真正入口。
Ctrl + Shift + F 搜索前先限定范围
直接按 Ctrl + Shift + F（macOS 为 Cmd + Shift + F）打开全局搜索后，别急着输关键词。先看搜索面板第二行的 “files to include” 输入框：
- 填
src/**/api/*.ts：只搜 API 层的 TypeScript 文件，避开test或mock目录干扰 - 填
**/components/**：锁定组件目录，避免在utils或hooks里误改逻辑 - 填
!**/legacy/**,!**/*.spec.ts：主动排除已废弃模块和测试文件，结果更干净
这种写法比“全量搜完再手动过滤”快得多，也更接近代码的真实组织意图——你不是在搜文本，是在搜“某类职责的实现位置”。
用 Ctrl + P + @ 快速跳转到符号定义
当看到一个函数名（比如 formatCurrency），想确认它是否被多处复用、参数是否一致、有没有副作用，Ctrl + P 后输入 @formatCurrency 比在全局搜字符串更可靠：
- 它基于语言服务解析 AST，能区分变量声明、函数定义、类型别名等语义层级
- 不会匹配到注释里的
// formatCurrency is deprecated这类干扰项 - 支持模糊匹配：输入
@cur也能列出currencyFormatter、getCurrentRate等相关符号
这个操作不依赖文件路径，只依赖符号命名质量——反过来也倒逼你给函数起清晰、唯一、带职责暗示的名字。
搜索时启用 Match Whole Word 和 Match Case
默认全局搜索会匹配子串，容易误伤。比如搜 id，可能把 user_id、identity、identifier 全列出来。这时点搜索框右上角的 ab（Match Whole Word）和 Aa（Match Case）图标：
- 搜
userId时开启Aa，避免匹配到userid（大小写不一致通常意味着不同约定） - 搜
props时开启ab，排除properties或proposals - 这两个开关一开，结果数量常减少 60% 以上，且每条都更可能真相关
这不是为了“少点结果”，而是让每次搜索返回的都是可直接推理的上下文片段——这才是可读性落地的关键瞬间。
别忽略 search.exclude 配置的隐性影响
很多人改了 settings.json 里的 search.exclude，却没意识到它会影响符号跳转和引用查找。例如：
- 若配置了
"**/generated/**": true，那Ctrl + Click跳转到某个生成的类型定义时，VSCode 可能提示“未找到定义” - 若误加了
"**/types/**": true，Ctrl + Shift + O就看不到自定义类型声明 - 检查当前工作区的
.vscode/settings.json，优先用files.exclude控制资源管理器显示，而用search.exclude专注控制搜索边界
真正难的不是记住快捷键，而是理解每个开关背后对“代码如何被理解”的建模假设——一旦配错，编辑器就从助手变成谜题制造者。
