VSCode全局替换需用Ctrl+Shift+H（Win/Linux）或Cmd+Shift+H（macOS）打开“在文件中查找”面板，设置范围、开关及正则后执行；替换不自动保存，需手动保存并检查Git状态。
VSCode 全局替换不是靠 Ctrl+H 就能搞定的——它默认只作用于当前文件，真要跨文件批量改，必须主动激活“在文件中查找”模式，否则改得再快也是白忙。
全局替换必须先打开“在文件中查找”面板
很多人按 Ctrl+H 后直接输内容、点全部替换，结果发现只改了当前标签页。这是因为 Ctrl+H 默认是“在当前文件中替换”。真正触发全局搜索/替换的是 Ctrl+Shift+H（Windows/Linux）或 Cmd+Shift+H（macOS）。
- 快捷键
Ctrl+Shift+H会直接聚焦到“在文件中查找”面板，左侧是搜索框，右侧是替换框 - 面板顶部有三个关键开关：
Match Case（大小写敏感）、Match Whole Word（全字匹配）、Use Regular Expression（正则模式），它们会影响所有匹配结果，不是仅影响预览 - 如果没看到“替换”输入框，说明你还没按
Ctrl+Shift+H，而是误用了Ctrl+H
替换前务必确认搜索范围和文件类型
VSCode 的全局替换默认扫描整个工作区（workspace），但实际生效范围受两个地方控制：搜索框下方的“files to include”和“files to exclude”输入框，以及工作区根目录下的 .vscode/settings.json 中的 search.exclude 配置。
- 常见漏改场景：想改所有
.ts文件，但没在“files to include”里填**/*.ts，结果连node_modules里的都扫了，或者根本没扫到子目录 - 安全做法：首次全局替换前，在“files to include”里明确限定，比如
src/**/*.ts；需要排除时，用!src/test/**或直接在设置里配"search.exclude": {"**/dist/**": true} - 注意：路径通配符用的是 glob 语法，
**表示递归任意层，*只匹配单层
正则替换要小心捕获组和转义字符
启用 Use Regular Expression 后，$1、$2 这类反向引用才能生效，但很多初学者卡在两处：括号没转义、美元符被当字面量处理。
- 要替换
console.log('xxx')为debug('xxx')，搜索填console\.log\((.*)\)，替换填debug($1)—— 注意.和( )都要加反斜杠转义 - 如果替换内容里真要输出
$字符（比如写 shell 脚本），得写成$$，否则会被当成捕获组引用 - 测试建议：先关掉“替换”，只点“查找全部”，确认高亮区域完全符合预期，再点“全部替换”
替换后记得检查 Git 状态和未保存的编辑器
VSCode 全局替换不会自动保存所有被修改的文件，也不会帮你过滤已暂存（staged）的文件——这意味着你可能在没意识到的情况下，把不该动的文件也改了，且这些改动还处于“未保存”状态。
- 执行完“全部替换”后，底部状态栏会显示“X 个文件已更改”，但每个文件仍带圆点（●），代表未保存；必须手动
Ctrl+K S（全部保存）或逐个保存 - 更危险的是：如果某个文件已被
git add，而你又在 VSCode 里改了它，Git 会认为这是“已暂存 + 已修改”的混合状态，diff 容易看错 - 建议流程：替换 → 查看左侧 Explorer 中哪些文件变蓝（已修改）→ 打开 Source Control 面板 → 检查 diff 是否合理 → 再决定是否提交
最常被忽略的一点：全局替换不支持“预览并勾选替换”，所有匹配项是一次性执行的。一旦手滑输错正则或范围，恢复成本远高于单文件替换——所以每次操作前，花十秒确认范围和正则，比事后 git restore 快得多。
