VSCode 的搜索是两个正交的维度: 纵向是「作用域」(单文件 → 工作区 → glob 子集), 横向是「能力」(字面量 → 正则 → 捕获组替换)。 把这两个维度组合起来,就是今天要掌握的全部。

⌘F 看着简单,但搜索框右侧那三个小图标(Aa / Ab| / .*) 决定了你是用「字面量」还是「正则」、是「精确」还是「模糊」。 老司机 90% 的搜索都先调好这三个开关再开始打字。

三个开关

⌘F 完整快捷键

⌘F + ⌥⏎ 黄金组合

Day 05 已经预告过——这是多光标的另一条进入通道,而且比 ⌘⇧L 更精准: 你可以先用三个开关过滤(case-sensitive / whole-word / regex), 满意后 ⌥⏎ 把当前所有匹配一次性变成多光标。

// 场景:把变量名 "id" 改成 "userId" — 但不能误改 idx / uuid
const id = req.params.id;
const idx = list.indexOf(id);
const uuid = generateUuid();
const u = users.find(u => u.id === id);

// 步骤:
// 1. ⌘F 打开搜索框
// 2. 输入 id
// 3. ⌥W 打开 Whole Word(关键!避免命中 idx / uuid)
// 4. ⌥C 打开 Match Case(避免命中 ID)
// 5. ⌥⏎ 把所有 id 变多光标
// 6. Esc 关闭搜索框,继续保留多光标
// 7. ⌘← 跳到每个 id 前 → 输入 user → 末尾大写化

// 结果:
const userId = req.params.userId;
const idx = list.indexOf(userId);     // idx 没改
const uuid = generateUuid();          // uuid 没改
const u = users.find(u => u.userId === userId);

⌘⇧F 不是 ⌘F 的「升级版」—— 它是完全不同的工具。 它打开的是 Activity Bar 的 Search 视图,带左侧文件树预览,本身就是一个迷你 IDE。

全工作区搜索快捷键

files to include / exclude · glob 实战

Search 视图展开后会显示两栏 glob 输入: files to include(只搜哪里) 和 files to exclude(不搜哪里)。 glob 模式是搜索精度的第二把刀。

全局排除:search.exclude

不想每次都手填「排除 node_modules」?写进 settings.json 一劳永逸。 Day 03 的团队 .vscode/settings.json 模板里已经埋了一份,这里展开看一下。

// settings.json — User 或 Workspace 都可
{
  "search.exclude": {
    // 包管理器
    "**/node_modules": true,
    "**/__pycache__": true,
    "**/.venv": true,
    "**/vendor": true,

    // 构建产物
    "**/dist": true,
    "**/build": true,
    "**/.next": true,
    "**/coverage": true,

    // 锁文件(很大,几乎不需要搜)
    "**/pnpm-lock.yaml": true,
    "**/package-lock.json": true,
    "**/yarn.lock": true,
    "**/Cargo.lock": true,

    // 二进制/媒体(搜不出文本)
    "**/*.{png,jpg,jpeg,gif,svg,pdf,zip}": true
  },

  // 是否使用 .gitignore 自动排除(默认 true,推荐保持)
  "search.useIgnoreFiles": true,
  "search.useGlobalIgnoreFiles": true,
  "search.useParentIgnoreFiles": true
}

⌘F vs ⌘⇧F 决策表

正则的核心不是元字符,而是捕获组—— 把匹配中「我感兴趣」的部分用 () 包起来, 在替换时用 $1 $2 取出来重组。 看懂这一节,你的搜索能力会跨一个台阶。

VSCode 正则要点(基于 JavaScript RegExp)

五个高频配方(背下来)

三个常见陷阱

VSCode 一个极易被忽视的设计: 搜索结果窗口里的每一行都不是只读快照—— 你可以直接在结果上编辑、删除、排除,所有修改会同步回源文件。 这是「批量重构」最优雅的工作流。

三种结果操作

完整跨文件重构工作流

// 任务:把所有 createUser(name) 改成 createUser({ name })
// — 但有些地方接收的不是字面量 name,要排除

// 1. ⌘⇧H 打开全工作区替换
// 2. 开正则 .*
// 3. Find:    createUser\((\w+)\)
//    Replace: createUser({ $1 })
// 4. 不要立刻按 Replace All!先看结果窗口

// 5. 浏览每一条匹配,发现:
createUser(name);              // ✓ 应该改
createUser(getName());        // ✗ getName() 不能放成对象 key
createUser(currentUser);       // ✓ 改
createUser(undefined);        // ✗ undefined 是 reserved

// 6. 悬浮第 2 条结果 → 点 × 排除
// 7. 悬浮第 4 条结果 → 点 × 排除
// 8. 现在结果只剩 2 条 → 点 Replace All
// 9. 完成 — 误命中 0 个

Search Editor:把搜索结果保存成文件

工具栏的 Open in Editor 把当前搜索结果另存为一个 .code-search 文件。 这是 VSCode 一个低调但强大的功能——你可以:

• 保存调研笔记:研究开源项目时,把「所有 useEffect 调用」的搜索结果保存,边读边记
• 跨会话复用:同一组搜索条件下次打开继续看
• 分享给同事:.code-search 文件可以 git commit,review 别人的搜索发现
• 二次过滤:在 Search Editor 内继续 ⌘F 在结果里再搜

底层引擎:ripgrep

VSCode 的全工作区搜索底层就是 ripgrep(rg)—— Rust 写的高性能 grep。所以搜大型 monorepo 时也很快、自动尊重 .gitignore、不需要装额外索引。 Day 16 讲扩展时还会回到 ripgrep——它在终端里也好用。

三个 Lab 各对应今天三层能力: 单文件 + 多光标、 捕获组重写、 跨文件 + glob。

Lab 1 — ⌘F + ⌥⏎ 多光标

把下面这段贴入 VSCode,用 ⌘F → ⌥⏎ 把所有纯字面量 id 改成 userId(注意保护 idx / uuid)。

function process(id) {
  const idx = list.indexOf(id);
  const uuid = generateUuid();
  if (id) {
    return { id, idx, uuid };
  }
  return id;
}

步骤:

1. ⌘F 输入 id
2. ⌥W 打开 Whole Word(关键!避免误命中 idx / uuid)
3. ⌥C 打开 Match Case
4. 右下角应显示 「6 of 6」(全是 id)
5. ⌥⏎ 全选为多光标
6. Esc 关搜索框
7. 输入 userId

Lab 2 — 捕获组改 import 路径

下面这段是某次重构后产生的 import 列表,把所有 @/components/X 改成 @/ui/X。

import Button from "@/components/Button";
import { Card, CardHeader } from "@/components/Card";
import Input from "@/components/forms/Input";
import { Modal } from "@/components/feedback/Modal";
import logger from "@/utils/logger";       // ← 不能改

步骤:

1. ⌥⌘F(Win: Ctrl H)打开搜索 + 替换
2. 开正则 ⌥R
3. Find 框: @/components/(.+)
4. Replace 框: @/ui/$1
5. 逐条按 ⌘⇧1 替换,确认结果。注意第 5 行 @/utils/logger 不会匹配

Lab 3 — 全工作区 + glob 实验

用 Day 03 创建的 ~/vscode-day03-team 项目(或随便一个有几个目录的代码库)。

1. ⌘⇧F 打开 Search 视图
2. 展开 files to include / files to exclude 输入框
3. 在 include 里输入 **/*.json — 只搜 JSON 文件
4. 在 exclude 里输入 **/package*.json — 不搜 package.json / package-lock.json
5. 搜索词输入 "recommendations"
6. 结果窗口应只显示 .vscode/extensions.json
7. 点工具栏 Open in Editor → 看到 .code-search 文件被打开
8. (可选)⌘S 保存成 find-recommendations.code-search — 这就是搜索的「快照保存」

1. ⌘F 搜索框右侧的三个开关分别是什么?它们的快捷键是?
2. 「⌘F + ⌥⏎」组合做了什么?它和 ⌘⇧L 比有什么优势?
3. 正则替换里 \U$1 是什么意思?$0 和 $1 的区别是?
4. monorepo 中只想搜索 packages/api 下的 .ts 文件,glob 应该怎么写?
5. 大型跨文件替换最稳妥的工作流是什么?(预防替换出错)