ctrl+shift+h（windows/linux）或cmd+shift+h（macos）是vscode唯一全局替换快捷键，直接打开多文件替换面板；误按ctrl+h仅作用于当前文件，且必须确认面板已激活、焦点在搜索框、启用对应匹配选项（如正则、大小写）才能跨文件生效。
VSCode 全局替换快捷键到底怎么触发
不是所有“替换”都能跨文件生效，必须确认当前处于「全局搜索替换」模式，否则只会改当前文件。Windows/Linux 按 Ctrl+Shift+H，macOS 按 Cmd+Shift+H —— 这个组合键打开的是「搜索面板」的替换栏，不是编辑器右上角那个小输入框。
常见错误：误按 Ctrl+H（仅当前文件替换）或在没激活搜索面板时直接输内容，结果只改了光标所在行。
- 按完快捷键后，焦点会自动落到搜索框，此时可直接输入要找的文本
- 若面板已打开但焦点不在搜索框，按
Tab切换到搜索输入区 - 搜索框右侧的
.*图标控制是否启用正则，Aa控制大小写敏感，这两个开关不点开就默认关闭，容易漏匹配
正则替换改函数名或路径时的关键写法
想把 getUserInfo() 批量改成 fetchUserInfo()，但又不想误伤 getUserInfoById() 或注释里的字符串？得靠正则边界符和捕获组。
搜索内容填：\bgetUserInfo\b\(\)，替换内容填：fetchUserInfo()。\b 是单词边界，确保前后不是字母/数字/下划线；\(\) 中的反斜杠是转义括号，不然会被当正则分组用。
- 改 import 路径如
from './utils/helper'→from './lib/helper'，搜索：from\s+['"]\.\/utils\/([^'"]+)['"]，替换：from './lib/$1'——$1对应第一个括号捕获的内容 - 别在没测试的情况下直接点「全部替换」，先点「查找全部」看命中的位置是否合理
- 正则开启后，
.默认匹配任意字符（包括换行），如不需要，勾选右下角的.（点号图标）关闭「匹配新行」
替换后编译报错？检查 TypeScript 类型引用是否同步更新
VSCode 的全局替换不会自动更新类型定义、JSDoc 注释里的函数名，也不会修改 .d.ts 文件或第三方库声明。比如你把 formatDate 改成 toISODate，但某个 @param {formatDate} callback 注释还在，TS 编译器照样报错。
- 搜索时加上引号或花括号限定上下文，例如搜
"formatDate"或{formatDate}，避免误改变量名 - 改完后运行
tsc --noEmit或看 VSCode 底部状态栏的 TS 错误提示，重点关注「Cannot find name」类报错 - 如果项目用了 ESLint，建议顺手跑一次
npx eslint . --fix，它可能修复因命名变更导致的 no-unused-vars 等规则问题
大项目慎用「全部替换」，优先用「替换并跳转」逐个确认
几十个文件里混着真实调用、测试桩、mock 数据、旧注释，一锤子全换很容易引入隐藏 bug。VSCode 提供的 Enter（替换并向下）比 Alt+Enter（全部替换）安全得多。
- 按
Ctrl+Shift+H后，输入搜索/替换内容，再按Enter一次只换一个，并自动跳到下一个匹配项 - 遇到不确定的匹配（比如某处是字符串拼接：
funcName = 'get' + 'UserInfo'），按Escape跳过，别硬替 - 如果真要批量操作，先用
Ctrl+K Ctrl+P打开命令面板，运行Files: Add Folder to Workspace把待处理目录单独加进工作区，避免误触 node_modules 或 dist
真正麻烦的从来不是快捷键记不住，而是替换后没人验证那些没出现在编辑器预览里的地方——比如构建脚本里的字符串、CI 配置里的环境变量名、甚至数据库迁移文件里的 SQL 注释。
