VSCode全局替换误改文件主因是未用“包含文件”白名单精准限定范围，而依赖排除规则；应填*.ts等glob路径锁定目标，禁用正则混用，并手动保存修改。
为什么“全局替换”会误改不相关的文件
VSCode 的 Ctrl+Shift+H（或 Cmd+Shift+H）默认作用于整个工作区，但“整个工作区”不等于“所有文件”——它受 files.exclude、search.exclude 和面板里手动填写的排除规则影响。如果你没显式限定范围，它可能跳过你想要改的文件，也可能扫进你不该碰的 node_modules 或 dist。所谓“只对指定文件替换”，本质是**用包含规则精准收口，而非依赖排除逻辑兜底**。
用“包含文件”字段锁定目标文件（不是靠排除）
打开 Ctrl+Shift+H 后，在替换面板底部找到“文件包含”（Include files）输入框，这里填的是**白名单模式**，优先级高于任何 exclude 配置：
- 只改
src/utils/http.ts和src/api/client.ts？填：src/utils/http.ts,src/api/client.ts - 只改
pages/下所有.tsx？填：pages/**/*.tsx - 只改根目录下的
config.json和manifest.yml？填：config.json,manifest.yml - 想同时覆盖多个扩展名？填：
*.ts,*.tsx,*.js（注意：不支持{*.ts,*.tsx}这种写法）
别在“文件排除”里反复删删减减——那容易漏、难复现；直接写明“我要谁”，更可靠。
正则替换时，文件路径通配符和正则语法不能混用
“文件包含”字段只支持 glob 模式，不是正则表达式：
- ✅ 正确：
src/**/service*.ts（匹配src/legacy/serviceV1.ts和src/v2/auth-service.ts） - ❌ 错误：
src/.*/service.*\.ts（这是正则，VSCode 会当字面量处理，找不到任何文件） - ⚠️ 注意：
**表示任意层级子目录，*只匹配当前层级单个目录或文件名，?匹配单个字符
如果目标文件名有规律但不固定（比如 user-api-v1.ts、user-api-v2.ts），优先用 user-api-*.ts，而不是试图在“文件包含”里写正则。
多文件替换后，部分文件未保存导致改动丢失
VSCode 默认不会自动保存被替换的文件——即使你点了“全部替换”，那些文件仍处于“已修改未保存”状态：
- 检查左上角文件标签：带圆点标记的文件就是未保存的
- 快捷键
Ctrl+Shift+S（或Cmd+Shift+S）可一键保存所有已修改文件 - 更稳妥的做法：替换前先运行
git status确认工作区干净；替换后立刻git diff看真实变更，再决定是否提交 - 如果某文件被 VSCode 标记为“只读”或权限不足，替换操作会静默失败——此时面板里不会报错，但预览列表中对应行会灰掉或消失
真正容易被忽略的，是“文件包含”字段里路径大小写敏感性：在 Windows/macOS 上它通常不敏感，但在 Linux 工作区或 WSL 中，Src/ ≠ src/，必须严格匹配实际目录名大小写。
