Ctrl+Shift+H（Windows/Linux）或 Cmd+Shift+H（macOS）是VSCode全局替换的正确快捷键，直接打开“在文件中替换”视图；Ctrl+Shift+F仅打开搜索面板，无替换功能。
Ctrl+Shift+H 是全局替换的正确入口，不是 Ctrl+Shift+F
很多人一上来就按 Ctrl+Shift+F（或 Cmd+Shift+F），结果只打开了「搜索」面板——它能找，但默认不带替换框。真正触发全局替换动作的快捷键是 Ctrl+Shift+H（Windows/Linux）或 Cmd+Shift+H（macOS）。这个组合键直接唤起「在文件中替换」视图，省去手动点箭头展开替换栏的步骤。
常见错误现象：
- 按了
Ctrl+Shift+F后输完内容点「全部替换」没反应——因为那只是搜索结果页，没有替换上下文 - 误以为
Ctrl+H能跨文件——它只作用于当前打开的单个文件 - Mac 用户混淆
Cmd+Alt+F和Cmd+Option+F：它们是同一物理按键，但文档统一写作Cmd+Option+F，仅用于单文件替换
替换前必须手动点「查找全部」，否则 Replace All 会漏匹配
Replace All 按钮不会实时扫描整个工作区；它只对当前已列出的匹配项生效。如果你跳过「查找全部」这一步，直接输完就点替换，VSCode 可能只处理了缓存里前几条、甚至零条结果。
实操建议：
- 输入查找内容后，先按
Enter或点击搜索框右侧的放大镜图标（Find in Files） - 确认左侧结果树里出现预期的文件和行号，且数量合理（比如搜
console.log却只列了 2 行，大概率漏了） - 逐个点开 ▶ 展开上下文，检查是否误命中注释、字符串或测试文件
- 如果结果太多卡顿，先在
files to include填src/**/*.ts缩小范围，别硬等
正则替换写 $1 就行，写 \1 或 ${1} 全都无效
VSCode 的替换字段只认 JavaScript 风格的捕获组引用：、……写成 或 会被当普通文本原样输出，静默失败。
关键前提：
-
.*图标必须点亮（右下角显示Regex标签），否则(...)不被识别为捕获组 - 非捕获组
(?:...)不占编号，$1指的是第一个(...)，不是第几个括号 - 要字面输出
$abc，得写成$$abc；$&表示整个匹配内容 - 跨行匹配不能依赖 UI 上那个 ↵ 按钮——它只在
Ctrl+Shift+F搜索中有效，在Ctrl+Shift+H全局替换里不起作用；要用[sS]*或(.|\n)*
files to include/exclude 不填等于裸奔，node_modules 默认排除但不保险
VSCode 默认排除 node_modules、dist 等目录，但这个行为只在「未显式修改排除规则」时生效。一旦你在 files to exclude 里输过东西，再清空它，VSCode 并不会自动恢复默认排除列表。
安全做法：
- 首次用全局替换前，点
files to include右侧的…→Add pattern，明确填src/**/*.{js,ts,jsx,tsx} - 想搜
node_modules？必须手动清空files to exclude，或填!node_modules/** - 排除多个目录：用英文逗号分隔，如
node_modules, dist, build, *.log - 路径通配符注意大小写：
**/*.JS在 Linux/macOS 下不匹配.js文件
真正容易被忽略的，是「Replace All」没有撤销栈——它跨文件写内存，改完就得靠 Git diff 或上次提交来救。每次点之前，多花三秒看一眼左侧文件列表，比写十个 git reset --hard 省事。
