我被vite-plugin-style-import硬控了两个小时

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 环境直接跳过
  • 生产环境翻车 💥

💡 吃一堑长一智

使用任何第三方库时都要检查一下维护状态和更新频率,否则你就可能是下一个🤡🤡🤡(扑克牌的最大数 麦当劳的吉祥物 蝙蝠侠的大客户 哥谭市的大头目)。

相关推荐
月弦笙音9 小时前
【Vite】vite常用配置,一篇即可通吃
前端·性能优化·vite
前端很开门9 小时前
程序员的逆天操作,看我如何批量下载iconfont的图标和批量下载 svg 图标
前端·chrome·代码规范
m0_709788629 小时前
单片机点灯
java·前端·数据库
用泥种荷花10 小时前
【TTS实战】获取设备播放和麦克风权限
前端
RedEric10 小时前
Vue加载速度优化,verder.js和element.js加载速度慢解决方法
前端·javascript·vue.js·前端性能优化
刺客-Andy10 小时前
CSS中使用 HSL(Hue, Saturation, Lightness) 动态生成色值
前端·css·前端框架·vue
南北是北北10 小时前
为什么“以音频为主时钟”最稳,怎么做 A/V 同步
前端·面试
LHX sir10 小时前
巨头撤退,玩家内卷!2025,IoT平台的生死劫与重生路
开发语言·前端·物联网·低代码·ui·前端框架·交互
龙在天10 小时前
Tailwind 类名 记个规律大概,然后去文档查
前端