“包含文件”框填文件路径通配符以精确控制替换范围，如.css、/.vue、src//*.ts等，留空则受search.exclude限制；正则替换需用$1而非\1，且必须用“replace in files”才能真正写入磁盘。
全局替换时“包含文件”框到底填什么
VS Code 的“在文件中替换”（Ctrl+Shift+H）默认扫描整个工作区，但真正控制范围的是“包含文件”（Include files）输入框——它不是可选项，而是决定哪些文件参与替换的开关。填错格式，要么漏掉目标文件，要么误改无关文件。
常见错误现象：输入 css 或 .css 没效果；输入 src/components 却匹配不到子目录里的 Button.vue；用 **/api/** 想排除 API 目录，结果连 src/utils/apiClient.ts 也被跳过。
-
*.css：匹配所有层级的 CSS 文件（推荐用于纯后缀限定） -
**/*.vue：显式启用 glob 递归，比*.vue更可靠（尤其在多根工作区下） -
src/**/*.ts：只处理src下所有 TS 文件，不碰tests/或types/ -
{src,pages}/**/*.html：用大括号匹配多个目录（注意无空格、不支持嵌套） - 留空：等同于不限制，但会受
search.exclude静默拦截（见下一条）
为什么填了 *.ts 还搜不到 node_modules 里的 .ts 文件
因为 search.exclude 配置优先级高于“包含文件”——哪怕你写了 **/node_modules/**/*.ts，VS Code 仍会按默认规则跳过 **/node_modules/**。这不是 bug，是设计上的安全防护。
使用场景：你想批量修复某个依赖包里 patch 过的类型定义（如 node_modules/@types/react/index.d.ts），但搜索面板始终不显示结果。
- 检查方式：按
Ctrl+Shift+P→ 输入Preferences: Open Workspace Settings (JSON)→ 查看是否有"search.exclude"条目 - 临时绕过：在替换面板右上角点击
⋯→ 取消勾选「使用排除设置」（仅本次生效） - 永久修改（慎用）：在
.vscode/settings.json中添加"search.exclude": { "**/node_modules/**": false }，但记得加 Git 忽略提示 - 更安全做法：直接用文件管理器打开
node_modules子目录 → 在该目录下右键「在 VS Code 中打开」，再执行替换
正则替换时“包含文件”和捕获组怎么配合
“包含文件”管文件范围，“正则表达式”管内容逻辑，二者叠加才能精准重构。比如想把所有 class="old-comp-button" 改成 class="new-comp-button"，但只改 HTML 和 Vue 文件，且保留其他 class 不变。
容易踩的坑：开启正则后，class="old-comp-(\w+)" 匹配成功，但替换写成 class="new-comp-\1" 会失败——VS Code 用的是 JavaScript 正则引擎，必须用 $1，不是 \1。
- 启用正则：点击查找框旁的
.*图标（高亮状态才算开启） - 查找内容：
class="([^"]*)old-comp-(\w+)([^"]*)"（用非贪婪匹配避免跨属性） - 替换内容：
class="$1new-comp-$2$3"（$1和$3保留原 class 前后内容） - 包含文件：
*.html,*.vue（逗号分隔，不支持空格） - 务必先点「查找全部」预览上下文，确认
$2真的捕获到了button而不是整行
替换后文件没保存？别被 Replace All 欺骗
面板顶部的「Replace All」按钮只是内存替换，文件标题栏出现 ● 圆点 ≠ 已落盘。真正触发磁盘写入的是「Replace in Files」（两个重叠文档图标），它会逐个加载、修改、保存文件——包括你当前没打开的文件。
性能影响：如果「包含文件」范围过大（如填了 **/*），又没排除 node_modules，VS Code 可能卡住或崩溃，尤其在大项目里。
- 替换前：确保已提交 Git（
git add -A && git commit -m "before global replace"） - 替换中：观察右下角状态栏是否显示「正在搜索…」或「正在替换…」，长时间无响应就 Ctrl+C 中断
- 替换后：用
git status看变更列表，再git diff --no-color逐行核对，重点看是否误改了注释、字符串字面量或正则中的转义字符 - 验证：对关键文件手动打开，确认缩进、引号、换行符没被自动格式化污染（VS Code 默认粘贴时会按当前文件缩进对齐）
