VS Code全局替换需明确范围、模式和上下文，否则易误改；必须加载文件夹工作区，合理配置search.exclude与files to include，正则引用用$1而非\1，替换前须预览并用Git Diff审查。
VS Code 的全局替换不是“能用就行”，而是必须明确范围、模式和上下文，否则一按 全部替换 就可能改坏 node_modules 或误替字符串里的关键词。
Ctrl+Shift+H 打不开或只搜当前文件？检查工作区是否加载
这是最常被忽略的前提：VS Code 的全局替换（Ctrl+Shift+H）仅在「文件夹工作区」下生效。如果右下角状态栏显示 No folder opened，那快捷键实际退化为单文件替换。
- 必须通过
File → Open Folder…加载项目根目录，不能只用Open File… - 多根工作区（
.code-workspace）也支持，但要确认所有子文件夹图标无黄色感叹号 - 若已打开文件夹却仍无效，检查
settings.json中是否误设了search.exclude过于激进（如"**": true）
想只改 .ts 文件却没结果？靠 files to include 精确收口
默认全局搜索会跳过 node_modules、.git 等目录，但不会自动限定文件类型——不手动填 files to include，就等于在全部文本中大海捞针。
- 在搜索面板点击
…展开筛选项，在files to include输入**/*.ts（匹配所有子目录下的 TypeScript 文件） - 若只想改
src/api/下的，填src/api/**/*.ts；多个类型用英文逗号分隔：*.ts,*.js - 别依赖
files.exclude反向排除，容易漏——比如填了!dist但忘了!build，dist目录仍被跳过
正则替换时 $1 不生效？记住 VS Code 用的是 JS 风格语法
VS Code 的替换引擎基于 JavaScript 正则，捕获组引用必须用 $1、$2，不是 \1；换行符要写成 \n，不是字面量 。
- 错误写法：
console\.log$$([^)]+)$$ → logger.info(\1)（\1会被当字面量，不展开） - 正确写法：
console\.log$$([^)]+)$$ → logger.info($1) - 多行匹配必须开
.*按钮，且查找内容里显式写\n，例如：return;\n}替换为return null;\n} - 空格和缩进会被自动对齐——粘贴替换内容前，先复制原始行再编辑，避免混用 Tab 和空格导致格式错乱
替换后代码异常？预览和 Git Diff 是最后一道防线
VS Code 不校验语法，也不区分代码逻辑与字符串字面量。一个 user 可能是变量名，也可能是 "username" 里的子串。
- 执行
全部替换前，务必点查找全部（放大镜图标），逐个展开匹配项看上下文 - 替换完成后，不要直接保存——先打开
Source Control面板，用 Git Diff 逐文件审查改动，重点盯"xxx"、url: "xxx"这类易误中位置 - 关键项目建议：替换前
git checkout -b replace-xxx新建分支；替换后跑一遍单元测试，再人工抽查 3–5 个典型文件
真正危险的不是不会用功能，而是把 全部替换 当成无脑操作——它不理解业务语义，只认字节序列。每次敲下回车前，得问自己：这个匹配，是我要改的逻辑，还是恰好拼出来的巧合？
