VSCode全局替换需满足四条件：打开文件夹工作区、确认搜索作用域为“在文件中查找”、解除只读限制、点击“Replace in Files”落盘；正则须用$1引用捕获组，限定文件类型需调整exclude/include配置。
VSCode 的全局替换不是“按一次快捷键就完事”，而是由工作区状态、搜索范围配置、正则语法和写入机制共同决定的——漏掉其中任一环，都会导致搜不到、替不了、改不进磁盘。
Ctrl+Shift+H 没反应？你可能根本没打开文件夹工作区
快捷键 Ctrl+Shift+H（macOS 为 Cmd+Shift+H）只在已加载文件夹工作区时生效。如果右下角显示 No folder opened，它实际退化为单文件替换，不会扫描子目录。
- 必须通过
File → Open Folder…打开项目根目录，而非Open File… - 多根工作区（
.code-workspace）也支持，但需确认所有路径无感叹号图标（表示加载失败） - 仅打开单个
.ts或.vue文件时，Ctrl+Shift+H会静默失效，此时只能用Ctrl+H在当前文件内操作
搜得到却替不了？检查顶部图标、只读状态和写入按钮
搜索面板顶部图标决定作用域：蓝色文件夹 是全局，“灰色文档”只是当前未保存文件——哪怕你刚按了 Ctrl+Shift+F，也可能被静默降级。
- 点击搜索面板右上角
⋯菜单 → 勾选「在文件中查找」；或再按一次Ctrl+Shift+F强制重置 - 右下角若显示
Read-only，替换按钮会灰掉；需解除文件只读属性，或用管理员权限启动 VSCode -
Replace All按钮只修改编辑器内存，不写入磁盘；真正落盘必须点上方的Replace in Files（两个重叠文档图标） - 未打开过的文件（如新生成的
dist/*.js）不会被加载进编辑器，也就无法参与替换——它们压根不在内存里
正则替换总出错？JS 引擎语法和转义规则必须记牢
VSCode 用的是 JavaScript 正则引擎，$1 和 \1 不等价，$ 后必须紧跟数字，否则会被当字面量处理。
- 捕获组引用一律用
$1、$2，写\1或$$1会静默失败（界面不报错，也不替换） - 要输出字面量
$1，得写成$$1；要换行符，得写\n，不是 - 中文括号、全角符号、未转义的
.或/会导致正则静默失效；建议先关掉.*确认普通文本能搜到，再逐步加正则 -
.*默认不跨行；匹配多行内容需勾选.*旁的dotAll模式，或用[\s\S]*
限定文件类型却搜不到？search.exclude 和 files.exclude 在背后拦截
默认情况下，VSCode 会跳过 node_modules、.git、dist 等目录，但这个行为可被用户级或工作区级配置覆盖或强化。
- 点击搜索框右侧
⋯→ 展开files to include和files to exclude输入框 - 想只搜
.vue文件，在files to include填**/*.vue；想包含dist，就在files to exclude里删掉它或清空 -
search.exclude是用户级配置（影响所有项目），而.vscode/settings.json中同名项优先级更高，会覆盖前者 - 大项目（>10k 文件）可能因性能限制漏搜；确认
search.useRipgrep为true（默认开启），禁用后会回退到慢一个数量级的 Node.js 实现
最容易被忽略的其实是“替换后没 Git 差异”——这九成说明你只点了 Replace All，没点 Replace in Files，也没手动保存。真实写入磁盘只有两个路径：要么点那个双文档图标，要么全部替换后按 Ctrl+K S 保存所有已修改文件。
