ctrl+shift+n 在 monorepo 中搜不到子包文件，因子包未被标记为 sources root 或未在 modules 中识别；需右键子包目录→mark as sources root，并启用 package.json-based libraries 支持。
Ctrl+Shift+N 在 Monorepo 里搜不到包内文件？
默认情况下，Ctrl+Shift+N 只索引已打开的模块（即被 IDE 识别为“module”的目录），而 Monorepo 中大量子包可能只是普通文件夹，没被标记为源根。结果就是输入 packages/ui/Button.tsx 没反应，或只返回 node_modules 里的同名文件。
实操建议：
- 右键点击子包根目录（如
packages/ui）→ Mark Directory as → Sources Root；对每个需快速跳转的子包都执行一次 - 检查
File → Project Structure → Modules，确认所有子包都出现在列表中且类型为Source - 如果用 pnpm workspaces 或 turborepo，启用
Settings → Languages & Frameworks → JavaScript → Libraries → Enable package.json-based libraries，让 WebStorm 自动识别 workspace 成员
Ctrl+B 跳不到跨包导出的函数？
在 Monorepo 中，packages/core 导出一个工具函数，packages/app 通过 import { helper } from '@myorg/core' 引入——此时 Ctrl+B 点击 helper 常常卡在重导出层（比如 index.ts），不进真正实现文件。
原因在于 WebStorm 默认解析路径别名时，只走一层 package.json#exports 或 index.ts 重导出，不继续深挖。
实操建议：
- 在
tsconfig.json的compilerOptions.paths里确保映射完整，例如："@myorg/core": ["./packages/core/src/index.ts"]（而非仅["./packages/core"]） - 打开
Settings → Languages & Frameworks → TypeScript → Compiler → Use TypeScript language service，启用 TS 语言服务后Ctrl+B会按 TS 解析逻辑走，更准 - 临时解法：光标停在导入语句的
@myorg/core上按Ctrl+B，先跳到该包入口，再手动点进真正实现文件
Alt+F7 查找用法返回一堆无关的测试文件？
Alt+F7 在 Monorepo 中默认扫描整个项目，包括 __tests__、e2e/、stories/ 等目录，导致查找一个 hook 的真实业务调用点时，结果被 mock 实现和快照文件淹没。
这不是 bug，是设计行为：WebStorm 把所有子目录当作文档上下文统一索引。
实操建议：
- 右键点击目标符号 → Find Usages → 展开右下角 Scope 下拉菜单 → 选
Project Files（排除测试目录）或自定义范围 - 提前配置排除模式：
Settings → File Types → Ignore files and folders，加入**/__tests__/**;**/e2e/**;**/*.stories.tsx - 对高频使用的业务包，用
Ctrl+Shift+A搜 “Change Current Scope”，保存为 “Business Only” 快捷作用域，下次一键切换
Shift+Shift 全局搜索慢得像卡住？
Monorepo 动辄几百个包，Shift+Shift（Search Everywhere）首次启动时会加载全部符号索引，冷启动可能耗时 10–30 秒，期间 UI 冻结、输入无响应，容易误判为崩溃。
更隐蔽的问题是：它默认同时搜文件、类、设置、插件、甚至 IDE 日志关键词，干扰项太多。
实操建议：
- 首次使用后，索引会缓存到
~/.WebStorm202X.x/system/index/，后续启动快很多；但清理缓存（如升级版本后）会重来一遍 - 输入前先敲
:进入命令模式，再输关键词，可限定搜索类型，例如：:file ui/button（只搜文件）、:symbol useAuth（只搜符号） - 禁用非必要索引源：
Settings → Advanced Settings → Search Everywhere → Uncheck “Settings”, “Actions”, “Plugins”，专注代码层
Monorepo 的规模放大了 IDE 的索引负担，快捷键本身没变，但触发条件、作用范围和失败路径都更复杂。最常被忽略的是：所有这些导航能力，都依赖 WebStorm 正确识别子包结构——没标 Sources Root，后面所有跳转都是空中楼阁。
