From 8a94f535de8d8eda8995abe95b3b5646a88c4cb6 Mon Sep 17 00:00:00 2001
From: Your Name <you@example.com>
Date: Thu, 23 Jul 2026 14:27:41 +0800
Subject: [PATCH] =?UTF-8?q?fix(frontend):=20=E4=BF=AE=E5=A4=8D=20Vite=20?=
 =?UTF-8?q?=E7=BC=93=E5=AD=98=E8=BF=87=E6=9C=9F=E5=AF=BC=E8=87=B4=20elemen?=
 =?UTF-8?q?t-plus=20=E5=85=A5=E5=8F=A3=E8=A7=A3=E6=9E=90=E5=A4=B1=E8=B4=A5?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

问题原因:
- Vite dev server 长时间运行(跨天)后 deps 缓存过期
- import-analysis 阶段无法解析 element-plus 包入口
- 报错: Failed to resolve entry for package "element-plus"

解决方案:
- vite.config.js 添加 optimizeDeps.include 显式预构建 element-plus 等核心依赖
- package.json 添加 predev 脚本, npm run dev 前自动清 .vite 缓存
- 防止其他服务器 git pull 后同样踩坑
---
 frontend/package.json   |  1 +
 frontend/vite.config.js | 12 ++++++++++++
 2 files changed, 13 insertions(+)

diff --git a/frontend/package.json b/frontend/package.json
index 5fa6086..4db1cb1 100644
--- a/frontend/package.json
+++ b/frontend/package.json
@@ -4,6 +4,7 @@
   "version": "0.0.0",
   "type": "module",
   "scripts": {
+    "predev": "rm -rf node_modules/.vite",
     "dev": "node node_modules/vite/bin/vite.js",
     "build": "node node_modules/vite/bin/vite.js build",
     "preview": "node node_modules/vite/bin/vite.js preview"
diff --git a/frontend/vite.config.js b/frontend/vite.config.js
index 34ad7c7..8c612cb 100644
--- a/frontend/vite.config.js
+++ b/frontend/vite.config.js
@@ -11,6 +11,18 @@ export default defineConfig({
       '@': fileURLToPath(new URL('./src', import.meta.url))
     }
   },
+  // 显式预构建 element-plus，避免 Vite 缓存过期后
+  // 出现 "Failed to resolve entry for package element-plus" 错误
+  optimizeDeps: {
+    include: [
+      'element-plus',
+      '@element-plus/icons-vue',
+      'vue',
+      'vue-router',
+      'pinia',
+      'axios'
+    ]
+  },
   server: {
     host: '0.0.0.0',
     port: 3000,