全局搜索本身不提升可读性与维护性，但正确使用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 等相关符号

这个操作不依赖文件路径，只依赖符号命名质量——反过来也倒逼你给函数起清晰、唯一、带职责暗示的名字。

VSCode

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

下载

搜索时启用 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 专注控制搜索边界

真正难的不是记住快捷键，而是理解每个开关背后对“代码如何被理解”的建模假设——一旦配错，编辑器就从助手变成谜题制造者。