VSCode全局替换只作用于工作区已打开或搜索范围内的文件，因files.exclude/search.exclude过滤、大小写/全字匹配开关开启、目标文件未加入工作区等原因导致部分文件未被替换。
全局搜索替换时，为什么只替换了部分文件？
VSCode 的全局替换默认只作用于当前工作区已打开的文件或匹配搜索范围内的文件，但常被忽略的是 files.exclude 和 search.exclude 配置会静默过滤掉很多文件——比如 node_modules、.git、dist 目录，甚至你自定义的 **/*.log。另外，大小写敏感（Match Case）和全字匹配（Match Whole Word）开关没关也会导致漏替换。
- 检查左下角搜索框右侧三个图标：确保
Match Case和Match Whole Word按需关闭（尤其改变量名时通常要关全字匹配） - 点击搜索框右上角
...→Toggle Exclude Settings，确认search.exclude里没误加业务目录（如"src/api/**"） - 如果目标文件不在工作区根目录下，先用
File > Add Folder to Workspace把它加进来，否则不会被扫到
想跨文件批量改函数名，但怕误伤字符串和注释
直接搜 myFunction 并替换，很容易把 // 调用了 myFunction 或 'myFunction' 里的内容也干掉。VSCode 本身不带语义分析，所以得靠正则 + 上下文约束来收窄范围。
- 启用正则模式（搜索框右侧
.*图标），用\bmyFunction\b替代纯文本搜索，\b能排除myFunctionHelper这类连写 - 如果只在 JS/TS 文件中生效，搜索时在文件类型过滤框填
*.ts,*.js（注意逗号后不加空格） - 对函数调用场景更保险的做法：搜
(?，能匹配 <code>myFunction()但跳过obj.myFunction和myFunction: xxx
替换后发现 import 路径没跟着更新
VSCode 全局替换是纯文本操作，不会识别模块导入路径的语义。比如把 utils.ts 里的 formatDate 改成 dateFormat，但 import { formatDate } from './utils' 这行不会自动同步——因为搜索词根本没覆盖到引号内的路径或花括号里的名字。
- import 名称要单独搜：用正则
import\s+{[^}]*formatDate[^}]*}或import\s+\* as\s+formatDate分别处理命名导入和别名导入 - 路径本身（如
./utils）如果也变了，必须另起一次搜索，关键词设为旧路径字符串，别依赖“一次全搞定” - TS 项目建议配合
typescript.preferences.includePackageJsonAutoImports关闭，避免自动补全干扰人工替换节奏
大项目里执行全局替换卡死或漏文件
VSCode 默认对单次搜索限制 5000 个结果，超了就截断；同时，如果工作区包含大量二进制文件（.zip、.png）或巨型日志，搜索引擎会降级或跳过它们，导致看似“没反应”。
- 在设置里搜
search.maintainFileSearchCache，设为true可提速后续搜索（首次仍慢） - 临时删掉
search.exclude中的"**/*.log"等通配，避免引擎因文件太多直接放弃扫描 - 真遇到上万文件要处理，不如拆成两步：先用终端命令
rg -l 'oldName' | xargs sed -i 's/oldName/newName/g'（Linux/macOS），再回 VSCode 刷新看效果
真正麻烦的不是怎么点按钮，而是每次替换前得想清楚：这个词在代码里到底有几种合法出现位置，每种要不要动。漏判一种，后面 debug 就得翻一倍时间。
