全局搜索替换未生效主因是工作区未正确加载，必须通过“Open Folder”打开顶层文件夹而非单个文件；其次需检查排除规则、编码、深度限制及手动保存。
全局搜索替换为什么没生效？先确认工作区是否正确加载
VSCode 的全局搜索替换（Ctrl+Shift+H / Cmd+Shift+H）只作用于当前打开的文件夹或工作区（workspace），不是整个磁盘。如果你只是打开了单个文件，或者用“添加文件夹到工作区”但未保存为 .code-workspace，那搜索范围会意外变小。
检查左下角状态栏：如果显示“未打开文件夹”，说明你处于空工作区；如果只显示一个文件名（如 index.js），说明没加载项目根目录。必须通过 File → Open Folder… 打开包含全部源码的顶层文件夹（比如 my-project/），才能确保搜索覆盖所有子目录。
- 打开的必须是文件夹，不是单个文件或 ZIP
- 若使用多根工作区，确保所有相关文件夹都已加入且未被
"files.exclude"隐藏 - 搜索前留意右上角过滤器图标——它可能启用了
node_modules、dist等默认排除项，但这些是可编辑的
如何安全地批量替换而不误伤注释或字符串？启用正则 + 单词匹配
直接输入文本替换（如把 foo 换成 bar）极易出错：可能改掉 foobar 里的 foo，或注释中本不该动的 // foo is deprecated。关键在两个开关：
- 点开搜索框右侧的
.*图标启用正则表达式 - 点
\b图标（或按Alt+\）开启“匹配整个单词”（word boundary）
这样写正则：\bfoo\b 就只匹配独立单词 foo，不碰 foobar 或 myfoo。更进一步，若要跳过字符串和注释（比如 TypeScript 中只改变量名不改字符串字面量），需配合 ESLint 或专用重构工具——VSCode 原生搜索做不到语法感知，别强求。
替换后部分文件没更新？检查文件是否被 VSCode 标记为“已忽略”
即使文件在文件夹里，VSCode 也可能因配置跳过它。常见原因：
-
settings.json中设置了"search.exclude"，例如"**/build/**": true会跳过所有build子目录 - 项目根目录存在
.gitignore，而 VSCode 默认继承它（可通过"search.useIgnoreFiles": false关闭） - 文件编码异常（如含 BOM 的 UTF-16），VSCode 搜索引擎可能无法解析内容
验证方式：在搜索框输入一个确定存在于目标文件中的字符串，看结果列表是否包含该文件。如果不出现，就去检查排除规则；如果出现但替换后没变化，右键文件 → Reopen with Encoding 试试 UTF-8。
大项目卡顿或漏搜？调整搜索性能与深度限制
VSCode 默认限制搜索深度为 10 层、单文件大小为 128KB、总文件数约 5500 个。超限就会静默截断，不报错也不提示。
- 增大文件大小上限：在
settings.json加"search.followSymlinks": true和"search.quickOpen.includeSymbols": false（后者减少符号索引压力） - 提高深度：设置
"search.depth": 20（注意过高会显著拖慢响应） - 避免通配符滥用：搜索
**/*.ts比**/*快得多；替换前先用纯搜索确认命中范围
真正上万文件的项目（如大型 monorepo），建议优先用命令行工具（rg -l 'foo' | xargs sed -i 's/foo/bar/g'），VSCode 搜索本质是轻量前端方案，不是 grep 替代品。
最常被忽略的是：替换操作不会自动保存文件，必须手动 Ctrl+S 或启用 "files.autoSave": "afterDelay"；另外，被 Git 忽略但实际需要修改的配置文件（如 .env），得主动取消 "search.useIgnoreFiles" 才能搜到。
