From 9dab4efce3c12da1f897928c9f1c3377a67d4b08 Mon Sep 17 00:00:00 2001
From: "Ray.Hao" <1490493387@qq.com>
Date: Wed, 8 Jul 2026 18:40:10 +0800
Subject: [PATCH] =?UTF-8?q?refactor:=20=E9=9D=A2=E5=8C=85=E5=B1=91?=
 =?UTF-8?q?=E7=A7=BB=E9=99=A4=E9=A6=96=E9=A1=B5=E5=9B=BA=E5=AE=9A=E9=A1=B9?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 package.json                        |  2 +-
 src/components/Breadcrumb/index.vue | 27 ++++++++-------------------
 2 files changed, 9 insertions(+), 20 deletions(-)

diff --git a/package.json b/package.json
index c4398c0d..7c991dd6 100644
--- a/package.json
+++ b/package.json
@@ -1,7 +1,7 @@
 {
   "name": "vue3-element-admin",
   "description": "Vue3 + Vite + TypeScript + Element-Plus 的后台管理模板，vue-element-admin 的 Vue3 版本",
-  "version": "4.7.3",
+  "version": "4.7.4",
   "private": true,
   "type": "module",
   "scripts": {
diff --git a/src/components/Breadcrumb/index.vue b/src/components/Breadcrumb/index.vue
index d0900ed2..7414d530 100644
--- a/src/components/Breadcrumb/index.vue
+++ b/src/components/Breadcrumb/index.vue
@@ -1,6 +1,7 @@
 <template>
   <el-breadcrumb class="flex-y-center">
     <el-breadcrumb-item v-for="(item, index) in breadcrumbs" :key="item.path">
+      <!-- 末级或不可跳转的节点显示为纯文本，其余可点击 -->
       <span
         v-if="item.redirect === 'noredirect' || index === breadcrumbs.length - 1"
         class="color-gray-400"
@@ -28,11 +29,10 @@ type BreadcrumbRoute = {
 };
 
 const currentRoute = useRoute();
-// 默认补一个首页面包屑
-const dashboardRoute: BreadcrumbRoute = { path: "/dashboard", meta: { title: "dashboard" } };
 
-// 根据当前路由参数生成跳转路径
+// 面包屑取 matched 链，不拼首页（首页与一级菜单平级，非父级）
 const pathCompile = (path: string) => {
+  // 补全动态路由参数，如 /user/:id
   const { params } = currentRoute;
   const toPath = compile(path);
   return toPath(params);
@@ -40,9 +40,10 @@ const pathCompile = (path: string) => {
 
 const breadcrumbs = ref<BreadcrumbRoute[]>([]);
 
-// 生成面包屑列表
+// 生成面包屑：取路由 matched 中有标题的层级，
+// 用 meta.breadcrumb = false 可以隐藏某一级
 function getBreadcrumb() {
-  let matched: BreadcrumbRoute[] = currentRoute.matched
+  const matched: BreadcrumbRoute[] = currentRoute.matched
     .filter((item) => item.meta && item.meta.title)
     .map(({ path, name, redirect, meta }) => ({
       path,
@@ -51,25 +52,12 @@ function getBreadcrumb() {
       meta,
     }));
 
-  const first = matched[0];
-  if (!isDashboard(first)) {
-    matched = [dashboardRoute].concat(matched);
-  }
   breadcrumbs.value = matched.filter((item) => {
     return item.meta && item.meta.title && item.meta.breadcrumb !== false;
   });
 }
 
-// 判断是否为首页路由
-function isDashboard(route?: BreadcrumbRoute) {
-  const name = route?.name;
-  if (!name) {
-    return false;
-  }
-  return name.toString().trim().toLocaleLowerCase() === "Dashboard".toLocaleLowerCase();
-}
-
-// 处理面包屑跳转
+// 跳转：有 redirect 走 redirect，否则按路径（含动态参数先 compile）
 function handleLink(item: BreadcrumbRoute) {
   const { redirect, path } = item;
   if (redirect) {
@@ -83,6 +71,7 @@ function handleLink(item: BreadcrumbRoute) {
   });
 }
 
+// 路由变化就重算面包屑，但 /redirect/ 这类中转路由跳过
 watch(
   () => currentRoute.path,
   (path) => {