根本原因是工作区加载方式不同：a项目通过file→open folder…加载了完整根目录，b项目可能用open file…仅打开单个文件，导致ctrl+shift+h仅作用于该文件；需检查左下角状态栏是否显示“my-project/”而非“index.ts”或“no folder opened”。
为什么在A项目能全局替换，B项目却搜不到文件
根本原因是工作区加载方式不同：VSCode 的 Ctrl+Shift+H（或 Cmd+Shift+H）只作用于当前打开的**文件夹或工作区**，不是整个磁盘。如果 B 项目是用 File → Open File… 打开单个 index.ts，那搜索范围就只有这一个文件；而 A 项目大概率是通过 File → Open Folder… 加载了完整根目录。
检查左下角状态栏：
• 显示 No folder opened → 没加载任何文件夹
• 显示 my-project/（带斜杠）→ 正常
• 显示 index.ts（纯文件名）→ 退化为单文件搜索
- 多根工作区（
.code-workspace）也得确认所有子文件夹图标无感叹号，否则被标记为“未加载” - 若 B 项目用了符号链接，检查
search.followSymlinks是否为true（默认是），否则跳过链接目标 - 某些项目根目录下有
.vscode/settings.json，里面写了"search.exclude": {"**/src/lib/**": true}—— 这种配置优先级高于用户级设置，会静默过滤掉整块目录
HTML模板里批量改 class 名，怎么避免误伤字符串和注释
VSCode 原生搜索不解析语法，所以 class="old-btn" 和 // class old-btn is deprecated 都会被匹配到。靠开关组合能大幅降低风险，但不能 100% 规避。
- 必须同时开启两个开关：
Match Whole Word（\b边界） +Use Regular Expression（.*图标） - 搜索内容写成
\bclass="old-btn"\b，比单纯old-btn安全得多——它不会匹配new-old-btn或old-btn-wrapper - 更进一步，限定文件类型：在
files to include栏填**/*.html或**/*.vue，排除node_modules和dist（它们可能含已编译 HTML） - 如果要保留其他 class，用捕获组：
class="([^"]*)old-btn([^"]*)"替换为class="$1new-btn$2"，但注意：这种写法仍可能误改 JS 字符串里的 HTML 片段，关键业务请搭配 ESLintno-alert类插件做二次校验
TS 文件中重命名变量，为什么 Ctrl+Shift+H 不如 F2 可靠
F2 是语义级重命名，基于 TypeScript 语言服务分析 AST；Ctrl+Shift+H 是纯文本替换，不管上下文。两者定位逻辑完全不同。
- 比如把
userList改成users：
–F2只改声明、赋值、调用处的变量名，跳过字符串、注释、正则字面量
–Ctrl+Shift+H会把const userList = [];、console.log("userList")、/userList/.test(str)全部干掉 - 若坚持用全局替换，至少加三重防护：
• 开启Match Whole Word
• 在files to include中填**/*.ts
• 替换前点Review changes预览右侧差异，重点扫.json和.md文件是否被波及 - 大型重构（如函数签名变更）别硬刚正则，直接用
Refactor > Extract Function或Change Signature，这些才是 TS 插件提供的安全通道
替换了几十个文件，为什么有些没保存生效
VSCode 的替换操作默认只修改内存中的编辑器副本，**不会自动写入磁盘**。这是最常被忽略的环节。
- 替换完成后，所有被改过的文件标签页左上角会出现实心圆点（●），表示“已修改未保存”
- 手动保存方式有两种：
• 单个文件：Ctrl+S
• 所有已修改文件：Ctrl+K S（Windows/Linux）或Cmd+K S（macOS） - 更稳妥的做法是提前启用自动保存：
File > Auto Save→ 设为afterDelay（默认 1 秒），这样替换完几秒内自动落盘 - 注意：
Replace All in Files（搜索面板顶部双箭头按钮）和Replace All（替换框右侧小箭头）行为不同——前者才是真正写入文件系统的操作，后者只改当前结果列表，容易误以为已完成
git checkout -b replace-xxx，替换完立刻 git diff 看一眼，比事后救火强十倍。
