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

💡 吃一堑长一智

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

相关推荐
excel8 小时前
基于两台服务器的蓝绿切换实现零下线更新
前端
江城开朗的豌豆8 小时前
React生命周期:从诞生到更新的完整旅程
前端·javascript·react.js
江城开朗的豌豆8 小时前
Redux vs Context+Hooks:前端状态管理的双雄对决
前端·javascript·react.js
IT_陈寒8 小时前
SpringBoot性能翻倍!这5个隐藏配置让你的应用起飞🚀
前端·人工智能·后端
艾小码8 小时前
别再开无效复盘会了!前端工程师这样复盘,成长速度快人一步
前端
苏无逢9 小时前
CSS基础查缺补漏(持续更新补充)
前端·css
翻斗花园刘大胆10 小时前
JavaWeb之快递管理系统(完结)
java·开发语言·前端·jvm·spring·servlet·java-ee
正义的大古10 小时前
OpenLayers地图交互 -- 章节四:修改交互详解
前端·javascript·vue.js
深耕AI11 小时前
【9/10】前端认证整合:Vue.js 中处理 JWT,实现登录页面和受保护路由
前端·javascript·vue.js
摩羯座-1856903059414 小时前
VVIC 平台商品详情接口高效调用方案:从签名验证到数据解析全流程
java·前端·数据库·爬虫·python