先说结论一个前端库想被浏览器、Node、打包器都能“正确且高效”地引用不能只丢一个 dist 目录出去必须同时搞定两件事——多套产物以及一套能把不同产物精准分配给不同环境的声明规则。前者靠构建脚本后者靠 package.json 的 exports 字段。我在实际维护组件库和工具库的过程中被各种“明明能跑但就是报错”的问题折磨过很多次浏览器直接