vite-plugin-style-import导致Vite 构建失败,我被硬控了两个小时
💥 事故现场
本地开发好好的,一到 Docker 就翻车:
bash
ERROR failed to load config from /src/vite.
config.ts
ERROR error during build:
Error: Cannot find module 'consola'
Require stack:
- /src/node_modules/vite-plugin-style-import/dist/index.cjs
症状:本地能跑,Docker 崩溃 🤔
🔍 排查过程(踩坑实录)
第一步:看错误信息(废话文学)
错误堆栈指向 vite-plugin-style-import
,第一反应是:
"这插件怎么了?我又没改过它!" 😤
第二步:检查依赖(开始怀疑人生)
bash
grep -r "consola" package-lock.json
发现一堆 consola 相关的依赖,但版本乱七八糟:
consola@3.4.2
标记为optional: true
vite-plugin-html
嵌套了一个consola@2.15.3
vite-plugin-style-import
声明需要console@0.7.2
这时候想:"为什么有这么多版本?npm 你是不是有病?" 🤬
第三步:深入源码(真相大白)
打开 vite-plugin-style-import
的源码一看:
javascript
// dist/index.cjs 第10行
const consola = require("consola"); // 👀 用的是 consola
再看 package.json:
json
"dependencies": {
"console": "^0.7.2" // 👀 声明的是 console
}
卧槽!包名都写错了! 这就是传说中的"复制粘贴都能出错"系列 🤡
第四步:对比环境(恍然大悟)
本地为什么能跑?
bash
ls node_modules/ | grep consola
# 结果:consola <-- 居然有!
Docker 为什么崩?
bash
# Docker 环境严格按 package-lock.json 安装
# optional 依赖装不上直接跳过
# 顶级 node_modules 里没有 consola
这时候终于明白了:本地有"幽灵依赖"救了命,Docker 环境太干净反而翻车了 💀
第五步:分析包查找过程(技术深度)
Node.js 查找模块的规则很简单,但魔鬼在细节里:
🟢 vite-plugin-html 为什么能找到 consola?
bash
查找路径:
1. node_modules/vite-plugin-html/node_modules/consola ✅ 找到了!
↳ 因为它自己的 package.json 里正确声明了 consola 依赖
🔴 vite-plugin-style-import 为什么找不到?
bash
查找路径:
1. node_modules/vite-plugin-style-import/node_modules/consola ❌ 没有
↳ 因为它声明的是 console,不是 consola
2. node_modules/consola ❌ 顶级也没有
↳ 因为 Docker 环境跳过了 optional 依赖
3. ../node_modules/consola ❌ 向上查找也没有
↳ 最终 GG
关键差别:一个有自己的嵌套依赖,一个依赖声明写错了!
第六步:理解 optional: true 的坑
optional: true
听起来很温柔,其实是个狠角色:
json
"consola": {
"version": "3.4.2",
"optional": true // 🎯 这是个狠活
}
含义解释:
- 本地环境:"optional 装不上?算了算了,不影响开发" 😎
- Docker 环境:"optional 装不上?那就不装了,严格执行" 🤖
- 网络不好时:"optional 下载超时?跳过跳过,不影响主流程" ⏰
- 内部仓库缺包时:"optional 包找不到?无所谓,继续安装其他的" 🚫
结果就是:
- 关键依赖被标记为 optional
- 本地能凑合(有幽灵依赖兜底)
- Docker 环境直接跳过
- 生产环境翻车 💥
💡 吃一堑长一智
使用任何第三方库时都要检查一下维护状态和更新频率,否则你就可能是下一个🤡🤡🤡(扑克牌的最大数 麦当劳的吉祥物 蝙蝠侠的大客户 哥谭市的大头目)。