6.1.2.1 模块化与复用

文档摘要

6.1.2.1 模块化与复用你有没有在凌晨两点，盯着控制台里一行报错发呆？不是路径写错了——路径是对的。不是文件丢了—— 就在那儿，连最后修改时间都新鲜得能闻到 Git 的气息。也不是 TypeScript 编译失败—— 一路绿灯。可运行时，Webpack 打包后，模块就是死活找不到那个工具函数；而隔壁模块，用着同一份，却稳如磐石。这不是玄学。这是模块化复用中一个被千百次踩过、又千百次被轻描淡写跳过的“地雷”：路径别名（Path Alias）与树摇（Tree Shaking）的隐性冲突——更准确地说，是 ESM 动态导入语义下，TypeScript 路径映射与打包器解析逻辑的错位。