WebStorm不存在“一键分析未导入文件依赖”功能，因其仅基于显式import/require建模，不扫描未引入文件；灰色红边节点表示路径解析失败而非链接为空；查“谁该导入我”应使用Find Usages或Unused export检查；真实依赖关系须通过npm/pnpm命令验证。
为什么“一键分析未导入文件依赖”根本不存在
WebStorm 没有、也不会提供所谓“一键分析未导入文件的依赖”功能——因为“未导入的文件”在静态分析中就是不可见的。IDE 只对 import、require、export 等显式声明的模块关系建模，不会扫描项目里所有 .ts/.js 文件然后反向推测“谁可能用它”。所谓“未导入的文件”，本质是游离在模块图之外的孤岛，WebStorm 默认不索引、不关联、不检查其依赖项。
常见误操作包括：右键某个没被任何地方 import 的工具文件 → Diagrams → Show Dependencies，结果为空或报错；或期望 Optimize Imports 自动删掉“没人 import 它”的文件——这完全超出 IDE 能力边界。
- 真正能被分析的，只有当前文件中已写出的
import语句所指向的路径 - 如果路径解析失败（如别名未配、
baseUrl错、node_modules缺失），WebStorm 会标红，但不会帮你“猜”该连到哪 -
require('./utils' + suffix)这类字符串拼接路径，IDE 直接放弃解析，不报错也不建链
空链接（灰色带红边框节点）的成因与验证方法
在 WebStorm 的 Diagram 或 Dependencies 面板中看到灰色矩形+红色边框，不是“链接为空”，而是“路径解析失败”。它意味着 IDE 找不到这个 import 声明对应的实际文件位置，不是代码写错了，而是环境没搭好。
典型场景：
- TS 项目中用了
@/hooks别名，但tsconfig.json里没配"baseUrl": "./"和"paths": { "@/*": ["src/*"] } - JS 项目用了
jsconfig.json，但文件放在了src外，或compilerOptions.baseUrl指向错误 -
node_modules根本没装，或package.json缺失/格式错误（比如多了一个逗号） - 文件编码含 BOM，或某行
import后面多了个未闭合的单引号
验证是否真“空”？别信 Diagram，用 require.resolve()：
console.log(require.resolve('@/utils'))
在 Node.js 环境下运行这行，输出真实路径才作数；报 Cannot find module，说明问题出在配置或安装，不是代码。
想查“谁该导入我”？用 Find Usages + 符号导出检查
如果你想知道某个工具文件（比如 src/lib/api.ts）是否该被其他文件 import，关键不是看它有没有被导入，而是看它有没有导出可被引用的符号。
- 打开该文件，把光标停在
export function fetchUser的fetchUser上，按Alt+F7—— 如果结果为空，且你确认其他文件确实没 import 它，那它大概率是死代码 - 但如果它只导出了
type或interface，Alt+F7默认不显示类型引用（除非开启 TypeScript 的includeTypeReferences检查） - 更稳妥的是：菜单栏
Analyze | Run Inspection by Name，搜Unused export，选中整个src目录运行 —— 它会标记所有未被外部引用的export
注意：export default 和具名 export 在检测逻辑上不同，前者更容易被漏判，尤其当接收方用 import xxx from './api' 时，IDE 可能因重命名而丢失关联。
真正有用的“依赖快照”只能从命令行拿
WebStorm 的 Diagram 是源码 import 链快照，Dependencies 面板是 node_modules 的静态快照，二者都不等于真实运行时加载路径。要确认一个包到底装了几个版本、谁拉进来的、有没有被 overrides 替换，必须切 Terminal：
-
npm ls react-dom --why：定位react-dom的引入源头和冲突点 -
pnpm list --all | grep "unmet"：找缺失的peerDependencies（pnpm用户优先） -
npm ls --depth=1：快速过一遍直接依赖，比翻 Dependencies 面板更准（后者可能缓存滞后）
这些命令输出的是 package-lock.json 或 pnpm-lock.yaml 的真实状态，不受 WebStorm 解析配置影响。执行前确保 Terminal 当前目录是项目根，且 node_modules 已存在。
最常被忽略的一点：即使 import 语句能解析、Diagram 能画出来、Dependencies 面板显示正常，运行时仍可能加载错文件——因为 require.resolve() 才是最终仲裁者，其他全是推测。
