ctrl+shift+f 是单次按下即生效的全局搜索快捷键，并非需“按住不放”的四键组合；其失效常因系统级快捷键冲突或 vscode 的 focus 条件（如 editortextfocus）未满足。
Ctrl+Shift+F 为什么不是“按住不放”的四键组合
VSCode 的 Ctrl+Shift+F（macOS 是 Cmd+Shift+F）是两段式触发：先按 Ctrl+K 松开，再按 Ctrl+S 才能打开快捷键设置；但全局搜索本身是单次按下即生效的组合键——它不依赖状态保持，也不需要松开再按。很多人误以为要“同时按四个键”，结果无响应，其实是系统根本没收到完整事件。
- Windows/Linux 下若
Ctrl+Shift+F没反应，先检查是否有其他软件劫持了该组合（比如某些输入法、远程桌面工具或显卡控制面板） - macOS 上
Cmd+Shift+F可能被 Spotlight 或 Finder 快捷键覆盖，可在「系统设置 → 键盘 → 快捷键」中排查 - 终端聚焦时该快捷键默认失效——VSCode 的
when条件默认为editorTextFocus，此时必须先点进编辑器区域再按
files to include 输入框里写什么才真正生效
这个字段不是简单填路径，而是 glob 模式匹配，且对斜杠方向、通配符层级、排除语法都敏感。写错一个符号，就可能搜不到任何内容，或者反向把整个项目都扫一遍。
-
src/**：匹配src目录及其所有子目录下的任意文件（推荐用于前端项目主逻辑） -
**/*.ts, **/*.tsx：逗号分隔多个模式，只搜 TypeScript 文件（注意空格不能出现在逗号前后） -
!**/test/**, !**/*.spec.ts：用!排除测试相关路径（必须写在 include 字段里，不是单独的“排除”栏） - 绝对路径如
/home/user/project/src无效；相对路径必须以**/或./开头，否则会被当作字面量文件名匹配
正则搜索时常见的元字符陷阱
勾选 .* 启用正则后，.、*、?、^、$ 全部变成特殊含义，但 VSCode 默认使用 JavaScript 正则引擎，不支持 \d 或 \s 等 Perl 风格简写（除非开启 useUnicodeFlag 插件扩展）。
- 想搜函数定义：
function\s+\w+\s*\([^)]*\)\s*\{—— 注意\s+匹配空白，[^)]*防止跨行捕获错误 - 搜带引号的字符串：
["']([^"']*)["']，但实际会漏掉转义引号（如"a\"b"），这时得用更复杂的模式或改用“全字匹配 + Aa”组合 -
^和$默认匹配整行开头结尾；若想匹配文件开头或结尾，需配合[\s\S]*类写法，性能较差，慎用
替换操作前必须确认的三个条件
全局替换不是“点了就完事”，尤其当目标文本出现在注释、字符串、正则字面量里时，Alt+R 展开替换区后直接点“全部替换”，可能破坏代码语义。
- 先确认是否启用了
Match Whole Word（Aa 按钮）：避免把user替换成currentUser时，顺手把username也改了 - 检查当前搜索是否已启用正则：如果开了
.*，替换内容里的$1、$&会被解析为捕获组引用，不是字面量 - 观察“替换”按钮旁的灰色提示文字：VSCode 会在下方显示“将替换 X 处”，但如果文件被外部进程修改过（比如 Git 自动换行、Prettier 格式化中），这个计数可能不准，建议先点开几处人工核对上下文
Ctrl+Shift+F 前，你得快速判断：这次要不要区分大小写？是不是得限定在 src/api 下？那个变量名会不会在字符串里被误伤？这些决策比按键本身慢十倍。
