vscode全局替换失效主因是文件未被识别或未保存：工作区未加载、文件被排除、快捷键冲突、编码不匹配、第三方软件劫持、未手动保存、正则语法错误及多根工作区排除规则。
VSCode全局替换功能失效，90%不是功能坏了，而是它根本没真正“看见”你要改的文件——要么工作区没加载对，要么文件被规则跳过，要么你压根没点对按钮。
Ctrl+Shift+H 按下没反应？先查输入法和快捷键绑定
Windows 用户最常踩的坑：微软拼音/五笔默认把 Ctrl+Shift+F（注意是 F，不是 H）设为简繁切换，而 VSCode 的全局替换快捷键是 Ctrl+Shift+H。但很多人记混、按错，或误以为 Ctrl+Shift+F 是全局搜索入口，结果按了没反应。
- 右下角状态栏若显示“未打开文件夹”，
Ctrl+Shift+H实际退化为单文件替换，不会扫描子目录 - 在 VSCode 中按
Ctrl+K Ctrl+S打开快捷键设置，搜workbench.action.findInFiles，确认绑定是否被覆盖或禁用 - 若绑定为空或显示“已禁用”，右键重置，或手动添加：
{"key":"ctrl+shift+h","command":"workbench.action.findInFiles"} - 第三方软件（QQ、钉钉、OBS、有道词典）也可能劫持
Ctrl+Shift+H，临时退出逐一验证
替换了但文件没变？你只改了编辑器内存，没写入磁盘
VSCode 的 Replace All 按钮只修改编辑器内部缓存，不自动保存到文件系统。标题栏出现 ● 圆点 ≠ 已保存，只是表示有未提交更改。
- 必须手动按
Ctrl+S（或Cmd+S）才真正落盘；Git 状态无变化，八成就是漏这一步 - 没在编辑器里打开过的文件，
Replace All对它们完全无效——VSCode 不会预加载未打开的文件来执行替换 - 真要批量改所有匹配文件，得点搜索结果列表上方的
Replace in Files按钮（两个重叠文档图标），不是面板右上角那个Replace All - 启用
File > Auto Save并设为afterDelay，可避免手动保存遗漏
搜得到文件名，却找不到内容？检查编码、排除规则和加密拦截
VSCode 默认只索引 UTF-8 编码的文件内容。如果文件是 GBK、ISO-8859-1 或其他编码，哪怕肉眼可见中文，它也不会读取其文本内容进行搜索或替换。
- 右下角点击当前编码（如显示
GBK），选Reopen with Encoding→UTF-8；能正常显示中文后再试搜索 - 确认后点编码 →
Save with Encoding永久转为 UTF-8（注意：这会真实改写文件字节，协作前需同步团队） - 打开设置（
Ctrl+,），搜search.exclude，检查是否误加了宽泛规则，比如"**/*.js": true或"src/**": true - 企业环境常见：加密软件（绿盾、北信源、明朝万达）拦截后台读取，
rg.exe拿不到未打开文件的内容；双击打开某个文件后又能搜到，基本可锁定该原因
正则替换总出错？$1 和 不是一回事，换行和缩进也得手动处理
VSCode 用 JavaScript 正则引擎，捕获组引用只认 $1、$2。写 或 $$1 会静默失效——界面不报错，也不替换，只是原样保留。
- 查
class="([^"]+)"，替换填class="$1 is-primary"，不是class=" is-primary" - 要字面量输出
$1，得写成$$1；\n - 替换内容含缩进或空行时，粘贴进去的文本会自动按当前编辑器缩进设置对齐，可能意外改变格式
- 建议先复制原始行再修改，避免空格 /
Tab混用；复杂逻辑别硬靠正则，优先用 ESLint 或专用重构工具
最容易被忽略的一点：多根工作区里，某个子文件夹如果被 files.exclude 或 .gitignore 隐藏，且你没在搜索面板右上角点 ! 临时关闭排除规则，那它下面的所有文件都不会参与全局替换——连预览都看不到，更别说改了。
