ctrl+shift+h（windows/linux）或 cmd+shift+h（macos）是vs code全局替换的唯一直达入口，直接打开多文件替换视图，不依赖搜索面板；必须先执行find all再点replace all，且需手动保存。
Ctrl+Shift+H 与 Cmd+Shift+H 是全局替换的唯一直达入口
VS Code 不提供“先搜再换”的两步式全局操作，Ctrl+Shift+H（Windows/Linux）或 Cmd+Shift+H（macOS）直接打开多文件替换视图，不是搜索面板的变体，也不依赖 Ctrl+Shift+F 的结果。很多人按了 Ctrl+Shift+F 再找替换按钮，其实已经走偏——那个面板只支持查找，不支持替换。
常见误操作：
- 按
Ctrl+Shift+F后没反应，其实是面板卡在「当前文件」模式，右上角图标显示文档图标而非文件夹；此时应再按一次Ctrl+Shift+F或手动点 ⋯ →「在文件中查找」 - Mac 用户输
Cmd+Alt+F失效：系统级快捷键可能拦截，必须用Cmd+Option+F（Option 键即 Alt 键，但 VS Code 文档统一写作 Option） - 光标不在编辑器内（比如聚焦在终端、调试控制台或设置页），快捷键完全无响应
全局替换前必须手动执行 Find All，否则 Replace All 无效
Replace All 按钮不是实时扫描，它只作用于当前已高亮的匹配项。如果你跳过「Find All」直接点「Replace All」，VS Code 会静默忽略未加载的匹配——尤其在大项目中，搜索结果是分批加载的，首屏没刷完就点替换，大概率漏改。
正确流程：
- 输入搜索内容后，务必点击搜索框右侧的
Find All按钮（或按Enter），等右下角「搜索中…」消失、匹配数稳定显示（如 “127 个结果”） - 确认范围合理：右上角文件夹图标旁默认显示「工作区」，若想限定
src/**/*.ts，需点击 … →「Add pattern」手动添加，避免扫到node_modules - 勾选
.*启用正则前，先确认是否真需要——普通字符串替换不勾它更安全，避免.、*被当元字符误匹配
正则替换必须用 $1，\1 会被当字面文本处理
VS Code 使用 JavaScript 正则引擎，捕获组引用语法严格限定为 $1、$2……不支持 \1。写成 \1 不报错，但替换结果里直接出现字符串 \1，而不是你捕获的内容。
典型翻车场景：
- 查找：
console\.log\(["'](.+?)["']\)，替换填debugger; // \1→ 实际输出debugger; // \1，不是预期值 - 替换字段中要字面输出
$abc，得写成$$abc；单个$后接非数字会被忽略 - 括号必须是捕获型
(...)，(?:...)是非捕获组，不生成$1 - 跨行匹配需额外点
.按钮（图标带换行符），否则.不匹配换行符，^和$也仅作用于单行
全局替换不自动保存，改完必须 Ctrl+S
Replace All 只修改内存中的文件内容，不会触发自动保存。如果忘记 Ctrl+S，关掉标签页或重启 VS Code，所有替换将丢失。更隐蔽的问题是：右下角状态栏显示 Read-only 时，Replace All 按钮直接置灰，连点都点不了——此时要么解除文件只读属性，要么用管理员权限重启 VS Code。
建议习惯：
- 替换完成后，养成顺手
Ctrl+S的肌肉记忆 - 对关键文件，替换前先用 Git 暂存当前状态（
git add -u），避免误操作后无法回退 - 大范围替换（如整个
src）建议分批进行：先试src/utils/**/*.ts，确认逻辑无误再扩到全目录
