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，也可能被静默降级。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 点击搜索面板右上角 ⋯ 菜单 → 勾选「在文件中查找」；或再按一次 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 保存所有已修改文件。