vscode全局替换需在打开工作区前提下运行且不自动保存，必须确认右下角无“no folder opened”提示、检查aa/ab/.*三个开关状态、合理设置files to include/exclude过滤范围，并注意正则中转义与$1引用规则。

VSCode全局替换不是“Ctrl+H按完就完事”，它必须在工作区上下文中运行，且默认不保存修改——不手动保存，所有替换都只是内存里的临时变更。

全局替换前必须确认工作区已打开

如果右下角状态栏显示No folder opened，Ctrl+Shift+H实际退化为当前单文件替换，根本不会扫描子目录。必须通过File → Open Folder…加载项目根目录，或打开一个.code-workspace多根工作区。多根工作区里任一文件夹带感叹号图标，该路径下的文件也不会被搜到。

搜索框右上角三个按钮状态决定匹配结果

常见空结果或误替换，90%出在这三个开关上：

VSCode

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

下载

• Aa（区分大小写）：默认开启，搜User不会匹配user；批量改变量名时建议关掉
• ab（全字匹配）：开启后log不会匹配console.log里的log；但改类名如btn时开它可避免误中button
• .*（正则表达式）：一旦启用，.*+?等全部变成元字符；想搜字面量foo.bar得写成foo.bar

限定文件范围靠files to include和files to exclude

漏斗图标（⋯）点开后出现的两个输入框，是防止误改的最关键防线：

• 只改.vue文件：在files to include填*.vue，别用src/**/*.vue漏掉根目录下的App.vue
• 跳过生成目录：在files to exclude填node_modules, dist, build（英文逗号分隔，无空格）
• 排除特定文件类型：填!*.md, !*.json，注意!表示“排除”而非“包含”
• 这些过滤只作用于本次搜索，不影响settings.json里的search.exclude

正则替换里$1和 的写法容易错

捕获组引用和特殊字符在搜索/替换框中行为不同：

• 搜索框里写(console.log((.*?)))，括号要转义，.*?是非贪婪匹配
• 替换框里用$1引用第一个捕获组，不是
； 表示换行符，\n才是字面量
• 想在替换内容里插入制表符，写 ；插入字面反斜杠，写\
• 替换后所有文件仍处于未保存状态，必须按Ctrl+K S（保存全部）或逐个Ctrl+S

真正危险的不是找不到匹配项，而是预览里看着都对，一按Replace All才发现正则把注释块、字符串字面量、甚至JSON值全卷进去了——所以每次正则替换前，先检查三处：工作区路径、右上角开关状态、exclude列表是否漏了node_modules。