核心结论
类型声明可见、编译器能够解析导入,以及运行时能够真正加载模块,是三个不同层面。现代包通过 package.json 中的 exports、imports、type 和条件入口声明公开边界;TypeScript 项目的 module 与 moduleResolution 应匹配真实运行环境或构建工具。编辑器能跳转到声明文件,只能证明类型解析找到了一条路径,不能证明输出代码中的模块说明符能被 Node.js、浏览器或打包器正确加载。
底层机制
解析导入时,编译器会结合导入语法、当前文件格式、扩展名、编译选项、包元数据和可用条件寻找源码或声明文件。面向现代 Node.js