根本原因是项目索引未就绪、搜索上下文未对准、路径匹配规则被忽略或关键配置被意外修改；需检查.idea完整性、重载项目、区分search everywhere/文件名/文本搜索三类入口、排查排除规则与excluded标记，并清除缓存重建索引。
WebStorm全局搜索明明输入了正确关键词却找不到目标文件、函数或设置项，根本原因不是关键词输错，而是项目索引未就绪、搜索上下文未对准、路径匹配规则被忽略或关键配置被意外修改。
确认项目是否真正加载完成
Project 窗口显示“Loading…”或“No modules found”，说明 WebStorm 还没开始构建文件索引——此时任何全局搜索都注定为空。
检查项目根目录下是否存在完整的 【.idea 文件夹】；若该文件夹缺失、被 Git 忽略或内容为空，Project 树将无法初始化模块扫描。
右键 Project 标签页 → Reload project；若该选项不可见，直接按 Ctrl+Shift+O（Windows/Linux）或 Cmd+Shift+O（macOS）强制重载模块。
确保项目是以 “Open” 方式打开，而非 “Attach Directory” 或 “Add Content Root” —— 后者只挂载路径，不触发完整模块识别流程。
区分三种搜索入口的用途
方法一：双击 Shift（Search Everywhere）→ 用于跨语义查找：文件名、符号定义、IDE 操作、设置项、Git 命令等混排结果。搜函数必须按 Tab 切到「符号」标签页，否则 calculateTotal 会优先匹配 “Toggle Soft Wraps” 这类同名操作。
方法二：Ctrl+Shift+N → 专用于按文件名模糊匹配，支持 CamelCase（apiclient）和空格分隔（user profile），但 【不识别路径结构】；输 src/user 无效，profile.vue 才有效。
方法三：Ctrl+Shift+F → 真·项目级文本搜索，支持正则、大小写敏感、全词匹配；搜 localStorage.setItem 必须输入 localStorage\.setItem 并勾选「Regular expression」，否则点号不会被转义。
排查搜索范围被意外限制
第一步：点击搜索框右上角的 ⋯ → 检查 File mask 是否误填了 !*.log 或 !node_modules；这些排除规则会直接屏蔽整个目录。
第二步：确认 Scope 设置为 “All Places”；若选 “Project Files”，而目标文件图标呈灰色（已被 Mark as Excluded），它就不会参与任何搜索。
第三步：右键可疑文件或文件夹 → 查看是否被误标为 “Mark as Plain Text” 或 “Mark as Excluded”；一旦标记，该文件将彻底退出索引，且不会在 Project 树中高亮显示。
第四步：观察右下角状态栏是否显示 “Indexing…”；若刚新建或批量修改文件后立即搜索，可能因索引滞后而漏掉最新内容，需等待索引完成再试。
解决汉化插件引发的搜索失效
中文插件可能覆盖 Ctrl+Shift+N 的快捷键绑定，或污染 .idea/workspace.xml 中的 searchDepth 配置，导致搜索框无法响应输入。
打开 Help → Find Action，输入 “Find File”，确认其绑定快捷键是否仍为 Ctrl+Shift+N；若被改写，右键 → Remove Shortcut → 再手动设回。
关闭 WebStorm 后执行 rm .idea/workspace.xml（保留 .idea 其他文件），重启 IDE 让其自动生成干净配置。
禁用输入法的 Ctrl+Shift 快捷键（如搜狗默认切换中英文），否则按键事件在到达 WebStorm 前就被系统截断。
验证并重建索引
第一步：点击 File → Invalidate Caches and Restart → 选择 “Invalidate and Restart”；仅 “Clear Cache” 不够，必须重建全文索引。
第二步：重启后进入 Settings → Editor → File Encodings，确保 Global Encoding、Project Encoding、Default encoding for properties files 三项均为 UTF-8，且勾选 “Transparent native-to-ascii conversion”。
第三步：在终端进入项目根目录，运行 find . -name "*.ts" | head -5 测试能否正常列出 TypeScript 文件；若连系统级文件遍历都失败，说明项目权限或磁盘挂载异常，WebStorm 无法读取文件内容。
