vs code 全局替换误改不相关文件的根源是未正确配置文件包含/排除规则：默认不跳过 node_modules 等目录，且 files.exclude 与 search.exclude 可能静默过滤结果；必须在“files to include”中显式指定目标文件模式（如 .ts 或 src//.{ts,tsx}），仅靠排除不安全。
为什么全局替换会误改不相关文件
VS Code 的 Ctrl+Shift+H（macOS 为 Cmd+Shift+H）默认搜索整个工作区，但**不会自动跳过 node_modules、dist、.git 等目录**——除非你显式配置了排除规则。很多用户发现替换后 package-lock.json 或 node_modules/react/index.js 也被动了，根源就是“文件排除”字段为空或被覆盖。更隐蔽的是：files.exclude 和 search.exclude 这两个设置项可能在用户/工作区配置里静默生效，导致某些文件根本不出现在搜索结果中，你以为漏了，其实是被过滤掉了。
必须填“包含文件”才能真正限定类型
只靠“排除 node_modules”不够安全，因为 src/index.tsx、public/index.html、README.md 都可能含相同文本。唯一可靠的方式是主动指定“只查哪些文件”：
- 在“在文件中替换”面板底部的
files to include输入框中，填*.ts（仅 TypeScript）、**/*.html（所有层级 HTML）、或src/**/*.{ts,tsx}（多扩展名） - 用
config/**/*.xml锁定子目录，比**/*.xml更精准，避免误触test/fixtures/sample.xml - 如果项目用 Monorepo 结构，可写
packages/ui/**/*.css，避免波及packages/cli
排除规则要写对路径模式，否则形同虚设
files to exclude 不接受绝对路径，只认 glob 模式，且需注意斜杠方向和通配符语义：
- 写
node_modules可以，但./node_modules或node_modules/无效 - 想排除所有构建产物，填
dist,build,.next,out（逗号分隔，无空格） - 排除某类文件但保留其目录？用
**/*.d.ts，不是*.d.ts（后者只匹配根目录） - 误写成
**/node_modules/**可能触发 VS Code 深度扫描卡死，尤其大项目
正则替换时范围控制失效的典型场景
启用 .* 正则模式后，若没同步限定文件范围，很容易在 JSON、CSV 或 Markdown 表格里误匹配：
- 搜
"name": "old"替换为"name": "new"，但package.json里"dependencies"字段也含"name"，一并被改 - 用
(?s)<!--[\s\S]*?-->清注释，若不限files to include: *.html，会把README.md里的<!-- comment -->也删掉 - 跨行正则如
import\s+\{([^}]+)\}\s+from\s+['"](.+)['"]若作用于.js和.ts混合项目，可能在 JS 文件里错匹配 TS 特有语法
真正关键的不是“怎么写正则”，而是“正则只跑在哪几个文件里”。每次点 Replace All 前，先看左侧结果树是否只展开你预期的目录——这是唯一能及时止损的信号。
