改整个工作区类名必须用 Ctrl+Shift+H（Win/Linux）或 Cmd+Shift+H（macOS）；Ctrl+H 仅限当前文件，无法完成跨文件类名重构。
VSCode 全局替换类名用 Ctrl+H 还是 Ctrl+Shift+H？
直接说结论：改整个工作区（多文件）的类名，必须用 Ctrl+Shift+H（Windows/Linux）或 Cmd+Shift+H（macOS）。Ctrl+H 只在当前文件内替换，对类名重构毫无意义——你不可能只在一个文件里改类名还指望项目能跑。
为什么直接搜“类名”替换常失败？
常见错误是输入 MyClass 就点全部替换，结果把字符串、注释、JSON 字段甚至变量名也一起干掉了。VSCode 默认不区分词边界、不识别语法上下文。
- 务必勾选
Match whole word（图标是↵），避免把UserClass里的Class替掉 - 强烈建议启用
Match case（Aa图标），防止把myclass或MYCLASS错误匹配 - 如果类名含驼峰（如
ApiService），可先试ApiService，再手动检查是否漏了apiservice等变体
更安全的做法：用 VSCode 内置重命名功能（F2）配合全局搜索
F2 是语义级重命名，它依赖语言服务（如 TypeScript 的 TS Server），能精准定位类声明、构造调用、继承关系等。但它默认只作用于当前文件——所以得组合使用：
- 在类定义处按
F2，输入新类名，回车 → 当前文件内所有引用自动更新 - 然后立刻按
Ctrl+Shift+H，搜索旧类名（确保勾选Match whole word和Match case）→ 检查是否还有残留（比如 import 路径、文档注释、测试文件、配置 JSON） - 特别注意
import语句：TypeScript 的F2通常会更新，但 JS 或未启用语言服务的项目不会
遇到正则或路径类名时怎么处理？
比如类名出现在 import 路径中：import { UserService } from '@/services/user.service';，此时类名和文件名耦合。单纯文本替换会出错：
- 别直接搜
UserService并替成UserAPI，否则路径仍为user.service，运行时报错 - 先手动重命名文件（右键 →
Reveal in Explorer→ 改名），再用F2重命名类，最后用Ctrl+Shift+H扫描 import 路径是否同步 - 如果路径里硬编码了类名（如
const type = 'UserService'），这类必须人工判断——VSCode 不会猜你是不是在做类型字符串映射
真正麻烦的从来不是快捷键按哪几个，而是哪些地方根本不能靠搜索替换解决。比如装饰器元数据、动态 require、字符串拼接的类名——这些得翻代码逻辑，不是 Ctrl 键按得快就能绕过去的。
