ctrl+shift+h需在文件夹工作区生效，路径须用glob语法（如src/views/*/.vue），替换后需手动保存，正则跨行需显式写\n，捕获组用$1而非\1。
Ctrl+Shift+H 找不到目标文件？先确认工作区和路径是否生效
VSCode 的 Ctrl+Shift+H（macOS 为 Cmd+Shift+H）默认只在已打开的文件夹工作区中生效。如果右下角状态栏显示 No folder opened 或只显示单个文件名，那替换操作根本不会扫描子目录——它只会作用于当前编辑器里那个文件。
必须通过 File → Open Folder… 打开项目顶层目录（比如 my-app/），确保所有目标文件都在该目录树下。多根工作区也支持，但需检查每个根目录旁没有感叹号图标（表示加载失败）。
常见误操作：
- 用
File → Open File…打开单个.ts文件后按Ctrl+Shift+H—— 此时仅对该文件生效 - 路径填了
src/components却没加**/*.vue，导致 VSCode 不理解这是 glob 模式，直接当字面路径匹配失败 -
search.exclude用户级配置覆盖了当前项目设置，把本该包含的目录（如dist/）静默排除了
“包含文件”里怎么写路径才能精准命中指定目录？
关键不是“能不能”，而是“怎么写才不漏、不错”。VSCode 的 files to include 支持 glob 语法，但行为和 shell 略有不同：它基于路径匹配，不解析文件内容，也不做语法感知。
正确写法示例：
- 只改
src/views下所有 Vue 文件：src/views/**/*.vue - 同时覆盖
src/pages和src/layouts：{src/pages,src/layouts}/**/*.vue - 想包含
dist/下的 JS（默认被排除）：dist/**/*.js，且需清空files to exclude或显式删掉dist - 避免误伤测试文件：
src/**/*.{ts,js}+ 在files to exclude填**/test/**, **/*.spec.ts
注意：** 表示任意层级子目录，* 只匹配当前层；路径分隔符统一用 /，即使在 Windows 上也不要用 \。
为什么替换了却没保存？或者部分文件没更新？
替换完成后，VSCode 不会自动保存修改过的文件——它们只是处于“已修改未保存”状态。如果你关掉编辑器或执行 Git 操作前没手动保存，所有更改就丢了。
更隐蔽的问题是“文件被忽略”：
- 某些文件虽在磁盘上，但被
files.exclude或search.exclude配置屏蔽，搜索面板里根本不会列出 - 文件编码异常（如含 BOM 的 UTF-8 或 GBK）可能导致 VSCode 无法正确读取内容，匹配结果为空
- 大文件（>50MB）默认被跳过，可在设置中调高
search.followSymlinks和search.useRipgrep相关阈值，但不推荐强行搜超大日志
验证方式：替换后立刻按 Ctrl+K S（保存全部），再看 Git 状态或左侧资源管理器里文件名是否变蓝（已修改）。
正则替换跨行或带引号内容时容易踩哪些坑？
VSCode 使用 JavaScript 风格正则引擎，不支持 [\s\S] 这类跨行匹配语法（除非开启 dotAll 标志，但 UI 里没开关）。想匹配换行，得显式写 \n 或 \r\n。
典型翻车点：
- 搜
console.log(.*);想替换成debug($1);，但原始代码是多行的 ——.默认不匹配换行，得改成console\.log\([\s\S]*?\); - 替换字符串里含双引号，没转义：
"new value"写成"new \"value\""才安全 - 捕获组引用必须用
$1，不是\1；写错会导致替换结果出现字面\1 - 正则模式开启后，
.、?、+等字符全变成特殊含义，普通点号要写成\.
最稳妥的做法：先关掉正则，用纯文本试一次；再开正则，逐个添加 \ 转义，并用预览列表确认上下文是否符合预期。
