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