vscode全局替换实际是当前工作区范围内替换，需先通过file→open folder…打开项目根目录，确保状态栏显示“workspace: xxx”而非“no folder opened”，否则仅作用于已打开标签页；多根工作区下替换覆盖所有已加载文件夹，但受files.exclude等配置过滤。
全局替换前先确认工作区范围
VSCode 的「全局替换」实际是「当前工作区范围内替换」，不是整个磁盘或系统级搜索。如果你没打开文件夹或工作区，Ctrl+Shift+H（Windows/Linux）或 Cmd+Shift+H（macOS）只会搜索并替换「已打开的编辑器标签页」，极易漏改。
实操建议：
- 务必通过
File → Open Folder…打开项目根目录，确保左侧资源管理器显示完整文件树 - 检查左下角状态栏是否显示「Workspace: xxx」；若显示「No folder opened」，全局替换无效
- 如用多根工作区（.code-workspace 文件），替换会覆盖所有已加载的文件夹，但不包括被
files.exclude或search.exclude隐藏的路径
用 Ctrl+Shift+H 快速唤出替换面板
快捷键 Ctrl+Shift+H 是唯一可靠的全局替换入口。别依赖右键菜单或命令面板里的「Replace in Files」——后者名称易混淆，且默认不带替换输入框，需手动点放大镜图标才展开。
面板出现后注意三个关键区域：
-
顶部搜索框：输入要查找的原始字符串，支持正则（勾选
.*图标）、大小写（Aa）、全字匹配（\b） -
中间替换框：输入新字符串，不支持正则捕获组重用（如
$1），仅纯文本替换 -
底部文件范围：默认为
./，可手动改成src/**/*.ts或排除!node_modules；想跨多级目录必须用**，单个*只匹配一级
小心 node_modules 和构建产物被误改
默认情况下，VSCode 会搜索所有子目录，包括 node_modules、dist、build 等。一旦触发替换，可能破坏依赖或导致打包失败，且无法一键撤回（撤销只作用于当前文件，不是全部）。
安全做法：
- 首次执行前，先点「Replace All」旁边的「Preview」，看右侧预览列表是否含不该动的路径
- 在底部范围框中显式排除：
./ !node_modules !dist !build - 若需替换 JSON 或配置文件中的字段名，建议先关掉「Match case」和「Match whole word」，避免漏掉
userName和username这类变体
替换后检查未保存的修改和 Git 状态
VSCode 不会自动保存被替换的文件，所有改动都停留在编辑器缓存中。关闭窗口时会弹窗提示「是否保存更改」，但容易误点「Don’t Save」，导致白忙一场。
务必确认：
- 左侧资源管理器中，文件名旁出现圆点（●）表示已修改但未保存
- 右下角状态栏显示「x files dirty」，点击可批量保存
- 打开源码控制（
Ctrl+Shift+G），核对 Git 差异，尤其注意是否意外改了package-lock.json或第三方库的声明文件
真正麻烦的是跨文件引用一致性——比如把 apiUrl 替成 baseUrl，但忘了同步改 axios.defaults.baseURL 初始化处。这种逻辑耦合，工具扫不出来。
