必须先手动触发 find all 再执行 replace all，否则会漏匹配；需限定文件范围、正确使用正则捕获组、开启大小写与全字匹配开关，并配合 git 审查确保安全。
替换前必须手动触发 Find All，否则 Replace All 会漏匹配
VSCode 的 Replace All 按钮不重新扫描文件，它只作用于当前已加载的匹配项。如果你跳过 Find All 直接点替换，面板里没显示的匹配项就完全被忽略——尤其在大项目中，搜索结果可能被截断或延迟渲染。
- 务必先点搜索框右侧的放大镜图标（
Find All），等所有匹配项展开并加载完成 - 检查底部状态栏是否显示“X results in Y files”，确认数量合理；若明显偏少，可能是范围设置太窄或正则写错
- 遇到卡顿或无响应，先关掉正则模式（
.*图标）试试——某些低效正则（如.*开头+跨行）会让 VSCode 暂停响应
限定文件范围比事后 Git diff 更可靠
默认全局替换会扫整个工作区，包括 node_modules、dist、build 等目录，不仅慢，还可能破坏依赖或构建产物。
- 在“包含文件”输入框填明确路径模式，比如
src/**/*.ts或**/*.vue，别只写*.ts（它只匹配根目录） - 排除目录用“排除文件”框，填
node_modules, dist, build, *.min.js，多个用英文逗号分隔 - 路径通配符中
**表示递归子目录，*只匹配当前层，**/*.log≠*.log
正则替换时 $1 捕获组失效的常见原因
想用 $1 引用捕获内容却没生效？大概率是正则本身或面板配置出了问题。
-
.*图标必须点亮（启用正则），但.图标（跨行匹配）通常不要点——它让.匹配换行符，容易导致性能骤降且语义失控 - 括号必须是普通捕获组
(...)，(?:...)是非捕获组，不生成$1 - 替换字段里只认
$1，写\1会被当字面量处理；要输出真实$字符，得写$$ - 示例：查找
import\s+(\w+)\s+from\s+['"](.+?)['"]，替换为import $1 from "$2"—— 缺少任一括号或大小写不一致都会失败
区分大小写和全字匹配不是可选项，而是安全开关
不开启 Aa（Match Case）或 ab（Match Whole Word），一次替换可能同时改掉 userName、USERNAME 和 userNames，重构后编译直接报错。
- 改常量名（如
API_URL）或类名（如UserService）时，Aa必开 - 改变量名（如
count）时，ab必开，否则counter、account全中招 - 两者可叠加使用：同时点亮
Aa和ab，才能确保只动Count，不动count、COUNT、Counter
git status 确认工作区干净，替换后立刻 git add -p 逐块审查，比任何预设都管用。
