Ctrl+Shift+H（Win/Linux）或Cmd+Shift+H（macOS）是VSCode全局替换唯一正确快捷键，直接打开双输入框替换视图；Ctrl+Shift+F仅为只读搜索，不支持替换操作。
Ctrl+Shift+H 是全局替换的正确入口，不是 Ctrl+Shift+F
很多人误用 Ctrl+Shift+F（全局搜索）后，在结果列表里手动点替换——这根本不会触发批量替换逻辑。真正启动「多文件查找并替换」的快捷键是 Ctrl+Shift+H（Windows/Linux）或 Cmd+Shift+H（macOS）。它直接打开带双输入框的替换视图，左侧搜、右侧换，一步到位。
常见错误现象：
- 按了
Ctrl+Shift+F后找不到“替换”按钮——因为那只是只读搜索面板 - 按了
Ctrl+H却只改当前文件，没意识到这是单文件替换专用键 - Mac 用户输
Cmd+Alt+F没反应——实际应为Cmd+Option+F（Option 键即 Alt 键，但 VSCode 文档统一写作 Option）
启用全字匹配（\b 或 AaBb 按钮）防止替换被截断
想把 user 替成 account，却把 username、user_id 也一起改了？这是没开全字匹配的典型表现。
两种等效方式任选其一：
- 点击搜索框右侧的
AaBb按钮（图标为大小写字母叠加），启用“全字匹配”——简单场景首选 - 启用正则模式（点
.*按钮），在词前后加\b，如\buser\b——适合需要组合其他条件时，比如\buser(?=\.id)
注意：\b 是单词边界，不是空格；user （末尾带空格）和 user, 都能被 \buser\b 匹配，但 username 不会。
替换前必须先执行 Find All，否则 Replace All 无效
Replace All 按钮不实时扫描，它只作用于当前已高亮的匹配项。如果你输完查找内容就直接点“全部替换”，VSCode 会静默跳过——因为它还没生成任何匹配结果。
正确流程只有三步：
- 在查找框输入内容（例如
\bconsole\.log\b） - 按
Enter或点击右上角Find All按钮，确认下方列出所有目标位置 - 再点
Replace All——此时才真正执行
这个细节极容易被忽略，尤其在正则启用后未触发 Find All，会导致看似“没反应”，实则是没加载匹配集。
限定文件范围比盲目扫整个工作区更安全
默认 Ctrl+Shift+H 会遍历整个工作区，包括 node_modules、dist、.git 等目录，既慢又危险。
务必在搜索框下方的「files to include」中明确约束范围：
- 只改源码：填
src/**/*.ts或**/*.js - 排除构建产物：在「files to exclude」里加
**/dist/**、**/node_modules/** - 不确定时，先点右上角文件夹图标 → 选「Selected Folder」，手动指定
src目录再操作
正则替换中捕获组（如 $1）能否生效，取决于括号是否真实存在且编号连续；而范围控制一旦漏设，Replace All 就可能永久污染你不该碰的文件——它不走 Git 暂存区，也没有撤回机制。
