vscode全局搜索快捷键是ctrl+shift+f（win/linux）或cmd+shift+f（macos），非ctrl+f；后者仅限当前文件，前者默认扫描整个工作区，支持正则、大小写等选项，并可通过file:过滤器精准定位文件类型。
VSCode 全局搜索不是 Ctrl+F，用错快捷键就只能搜当前文件，根本没法维护跨文件的文档一致性。
Windows/Linux 下真正全局搜索的快捷键是 Ctrl+Shift+F
很多人按 Ctrl+F 后在右上角输入关键词，结果只在当前打开的文件里找——这其实是「局部查找」。文档维护常涉及 README.md、API 注释、配置说明、测试用例等多个文件，必须跨文件扫描。
-
Ctrl+Shift+F打开的是「搜索面板」，默认作用域为整个工作区（workspace），支持正则、大小写敏感、全词匹配等选项 - 如果没反应，检查是否误开了「远程 SSH」或「WSL」窗口但未连接成功——此时搜索面板可能卡在“正在加载”状态，换回本地文件夹再试
- 搜索前先确认左下角显示的是你期望的工作区根目录；若显示「No folder opened」，
File → Open Folder...再来
搜索时加 file: 限定范围能避开干扰项
文档类内容常混在代码、日志、node_modules 里，直接搜容易命中大量无用结果。用 file: 过滤器可精准定位文本类文件。
- 例如搜所有 Markdown 文档里的 “deprecated”，输入：
deprecated file:*.md - 想排除
node_modules和dist目录？在搜索面板右上角点「…」→「Add Folder to Exclude」，填入**/node_modules/**和**/dist/** - 注意
file:不支持绝对路径，只认 glob 模式；file:README.*可同时匹配README.md和README.txt
替换操作必须勾选「Use Regular Expression」才能安全更新多行文档结构
维护文档时经常要批量修改标题层级、参数列表格式或链接路径。普通字符串替换会破坏缩进和换行，而正则替换能保留上下文结构。
- 比如把所有二级标题
## API统一升级为三级标题：
查找：^##\s+(API.*)$，替换为：### $1，并确保勾选.*图标（即「Use Regular Expression」） - 替换前务必点「Replace All in Files」旁边的「Preview」按钮，逐条核对——VSCode 不提供替换撤销，一旦执行无法回退
- 正则中
^和$默认匹配整行，但如果目标文本含 Windows 换行符（\r\n），可能漏匹配；建议在设置里开启files.eol: "\n"统一换行符
真正卡住人的往往不是不会搜，而是搜完不知道哪些结果该动、哪些是生成文件或模板占位符。维护文档前，先花 30 秒看一眼 .gitignore 和项目约定的文档命名规范，比盲目替换更省时间。
