VSCode全局替换失效主因是工作区未加载、search.exclude拦截、正则未启用或写错、文件未保存；需通过Open Folder加载根目录，启用Replace in Files，检查Regex标签及包含/排除路径。
VSCode全局替换失效，八成不是功能坏了，而是你没在它真正“看得到”的范围内操作。工作区没加载、排除规则挡路、正则写错、甚至文件根本没保存——这些才是真凶。
为什么 Ctrl+Shift+H 按了没反应或只改当前文件
快捷键没失效，是模式卡住了。VSCode 默认打开的是「在当前文件中查找」，不是全局搜索。右上角如果显示灰色文档图标（而非实心文件夹图标），说明它压根没进全局模式。
- 按
Ctrl+Shift+F后，立刻点右上角的⋯→ 勾选「在文件中查找」；或者再按一次Ctrl+Shift+F强制切换 - 左下角状态栏必须显示具体文件夹路径（如
my-project/），若显示「No folder opened」或单个文件名（如index.ts），请务必通过File → Open Folder…重新加载顶层目录 - 多根工作区要检查每个子文件夹旁有没有黄色感叹号——有说明加载失败，可能路径不存在或权限不足
替换了但 Git 没变化，或部分文件完全没被扫到
VSCode 的 Replace All in Files 只写编辑器内存，不自动落盘。更关键的是：它只处理“已纳入搜索范围”的文件，而这个范围受多重过滤控制。
- 替换后标题栏出现 ● 圆点 ≠ 已保存，必须手动按
Ctrl+S才写入磁盘；建议开启File → Auto Save并设为afterDelay - 检查
search.exclude设置：打开Preferences: Open Settings (JSON)，确认没有误加"**/src/api/**": true这类规则 - 默认跳过
node_modules、dist等目录，若想搜它们，得在搜索面板下方的「files to exclude」框里清空内容，或临时填!node_modules/** -
.gitignore也会被默认继承，如需禁用，加配置"search.useIgnoreFiles": false
正则替换总出错：$1 不生效、换行匹配失败、大小写乱套
VSCode 用的是 JavaScript 正则引擎，语法和行为跟直觉有偏差。开关没开、引用写错、跨行没处理——三者占了 90% 的失败案例。
- 确认右下角显示
Regex标签，或按Alt+R（Win/Linux）/Cmd+Option+R（macOS）强制启用；没亮灯时，^、\d全当普通字符 - 捕获组只能用
$1，写\1或${1}会静默失败；要输出字面量$1，得写$$1 -
.默认不匹配换行符，多行匹配必须用[\s\S]*或勾选.*旁的 dotAll 按钮（仅在全局搜索有效） - 大小写敏感（
Aa按钮）、全字匹配（\b）会影响结果，批量前先点Find in Files看左侧树是否只有你想要的那些匹配项
搜索结果为空但文件明明存在
最隐蔽的问题往往藏在索引和权限里。VSCode 不是实时扫描硬盘，而是依赖构建好的文本索引，且对只读文件或无读取权限的目录直接跳过。
- 右下角若长时间显示「Indexing…」，可执行命令
Developer: Reload Window强制重建索引 - 检查目标文件是否被标记为只读（右下角显示
Read-only），此时替换按钮会灰掉，需解除系统级只读属性或用管理员权限重启 VSCode - Linux/macOS 下注意目录权限：
ls -l看是否有r权限；Windows 下检查文件属性里的「只读」勾选项 - 中文路径、含空格或特殊符号（如
[、]）的文件名，可能导致搜索服务无法解析，临时重命名测试可快速定位
真正难的不是学会所有开关，而是每次替换前花 5 秒看一眼左下角路径、右下角 Regex 标签、以及搜索面板上方的「files to include/exclude」字段——这三个地方，决定了你的替换到底作用在哪儿。
