refactor(PageHead): 页面头部组件目录化拆分（182→97行, -47%） #1177

Merged

auto-approve-bot merged 17 commits from refactor/pagehead-split into develop 2026-07-30 08:40:05 +08:00

Conversation 5 Commits 17 Files Changed 7

+181 -182

xiaoxia commented 2026-07-30 07:11:25 +08:00

Owner

Copy Link

Copy Source

拆分内容

PageHead 组件从单文件拆分为目录结构，降低单文件复杂度：

• types.ts - BreadcrumbItem、PageHeadProps 类型定义
• constants.ts - ROUTE_TITLE_MAP 路由标题映射常量
• utils.ts - generateBreadcrumb 面包屑生成工具函数
• PageHead.css - 样式文件（原文件移动）
• index.tsx - 主组件，精简至 ~97 行

变更说明

• 路径向后兼容：@/components/layout/PageHead 仍可正常导入（自动解析 index.tsx）
• 命名导出保持一致：BreadcrumbItem、PageHeadProps 类型继续从主入口导出
• 新增 PageHead.test.tsx smoke test，确保模块可正常加载

### 拆分内容 PageHead 组件从单文件拆分为目录结构，降低单文件复杂度： - **types.ts** - BreadcrumbItem、PageHeadProps 类型定义 - **constants.ts** - ROUTE_TITLE_MAP 路由标题映射常量 - **utils.ts** - generateBreadcrumb 面包屑生成工具函数 - **PageHead.css** - 样式文件（原文件移动） - **index.tsx** - 主组件，精简至 ~97 行 ### 变更说明 - 路径向后兼容：`@/components/layout/PageHead` 仍可正常导入（自动解析 index.tsx） - 命名导出保持一致：`BreadcrumbItem`、`PageHeadProps` 类型继续从主入口导出 - 新增 PageHead.test.tsx smoke test，确保模块可正常加载

xiaoxia added 8 commits 2026-07-30 07:11:25 +08:00

refactor(PageHead): 抽取类型定义 2e4b9dd512

refactor(PageHead): 抽取路由常量 4b474adbea

refactor(PageHead): 抽取面包屑工具函数 2b39f4a6f5

refactor(PageHead): 移动样式文件到目录 e477f776f1

refactor(PageHead): 目录化拆分，主组件精简到~100行 ba89f559bc

refactor(PageHead): 删除旧文件，已迁移到目录 2e61fca9e2

refactor(PageHead): 删除旧文件，已迁移到目录 df3e282d30

test(PageHead): 添加smoke test 9c75503a80

xiaoxia added 1 commit 2026-07-30 07:15:51 +08:00

fix(PageHead): types.ts添加React类型导入 eefd85d044

xiaoxia added 1 commit 2026-07-30 07:24:32 +08:00

fix(PageHead): 简化测试文件，只测纯函数避免React环境依赖 957f0117a3

xiaoxia added 1 commit 2026-07-30 07:41:29 +08:00

chore: 删除放错位置的测试文件（测试应在src/test/目录） eeb8f81b89

gitea-actions bot commented 2026-07-30 07:50:10 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

项目	详情
PR号	#1177
预览链接	https://pr-1177.preview.xiaoxiajianji.com
API环境	staging

💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。

🔄 每次提交新代码后预览环境会自动更新。

🗑️ PR 关闭或合并后，预览环境会自动清理。

🚀 **预览环境已部署** | 项目 | 详情 | |------|------| | PR号 | #1177 | | 预览链接 | [https://pr-1177.preview.xiaoxiajianji.com](https://pr-1177.preview.xiaoxiajianji.com) | | API环境 | staging | > 💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。 > > 🔄 每次提交新代码后预览环境会自动更新。 > > 🗑️ PR 关闭或合并后，预览环境会自动清理。

xiaoxia added 1 commit 2026-07-30 08:13:10 +08:00

style(PageHead): 修复Prettier格式 ccf05be7a5

xiaoxia added 1 commit 2026-07-30 08:13:11 +08:00

style(PageHead): 修复Prettier格式 2aeef415cb

xiaoxia added 1 commit 2026-07-30 08:13:14 +08:00

style(PageHead): 修复Prettier格式 dfc627887e

auto-approve-bot approved these changes 2026-07-30 08:15:29 +08:00

auto-approve-bot left a comment

Collaborator

Copy Link

Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。

auto-approve-bot approved these changes 2026-07-30 08:15:29 +08:00

auto-approve-bot left a comment

Collaborator

Copy Link

Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。

xiaoxia added 1 commit 2026-07-30 08:18:34 +08:00

test(PageHead): 移动测试文件到目录结构匹配源文件 52772064a1

xiaoxia added 1 commit 2026-07-30 08:18:35 +08:00

test(PageHead): 删除旧位置的测试文件（已移到PageHead/index.test.tsx） 625b754015

auto-approve-bot commented 2026-07-30 08:23:14 +08:00

Collaborator

Copy Link

Copy Source

【阻塞级判定】

• 是否存在阻塞级问题：否
• 阻塞级问题数量：0 个

📊 审查概览

• 整体评价：通过
• 建议级问题数量：0 个

🔴 阻塞级问题（必须修复）

无

💡 改进建议（不阻塞合并）

无

✅ 良好实践

1. 关注点分离：将原本单文件组件中的类型定义、常量映射、工具函数拆分到独立的 types.ts、constants.ts、utils.ts 文件中，结构清晰，易于维护。
2. 类型导出：在 index.tsx 中统一导出了类型定义，方便外部引用组件时进行类型约束。
3. 逻辑保留：重构过程中完整保留了原有的面包屑生成逻辑和组件行为，确保功能一致性。

---

✅ 格式检查通过 | ✅ 逻辑审查通过 | ✅ 性能良好

---

_{🤖 由 AI 代码审查机器人自动生成 | 2026-07-30 00:23:14 | 模型:}

### 【阻塞级判定】 - 是否存在阻塞级问题：否 - 阻塞级问题数量：0 个 ### 📊 审查概览 - 整体评价：通过 - 建议级问题数量：0 个 ### 🔴 阻塞级问题（必须修复） 无 ### 💡 改进建议（不阻塞合并） 无 ### ✅ 良好实践 1. **关注点分离**：将原本单文件组件中的类型定义、常量映射、工具函数拆分到独立的 `types.ts`、`constants.ts`、`utils.ts` 文件中，结构清晰，易于维护。 2. **类型导出**：在 `index.tsx` 中统一导出了类型定义，方便外部引用组件时进行类型约束。 3. **逻辑保留**：重构过程中完整保留了原有的面包屑生成逻辑和组件行为，确保功能一致性。 --- ✅ 格式检查通过 | ✅ 逻辑审查通过 | ✅ 性能良好 --- _{🤖 由 AI 代码审查机器人自动生成 | 2026-07-30 00:23:14 | 模型:} <!-- AI_CODE_REVIEW_AUTO_COMMENT -->

auto-approve-bot merged commit 18f534bbd6 into develop 2026-07-30 08:40:05 +08:00

auto-approve-bot deleted branch refactor/pagehead-split 2026-07-30 08:40:05 +08:00

gitea-actions bot commented 2026-07-30 08:41:24 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

PR #1177 已关闭或合并，对应的预览环境已被清理。

如有需要，可以重新打开 PR 来重新生成预览环境。

🗑️ **预览环境已清理** PR #1177 已关闭或合并，对应的预览环境已被清理。 > 如有需要，可以重新打开 PR 来重新生成预览环境。

Sign in to join this conversation.

Reviewers

No Reviewers

auto-approve-bot

Labels

Clear labels

P0

阻塞性，必须立即处理

P1

高优先级

P2

中优先级

P3

低优先级/后考虑

architecture

架构设计

backend

后端相关

blocked

阻塞中

bug

Bug修复

ci-bug

CI本身的bug

ci-optimization

CI优化类任务

ci-pipeline

CI流水线/workflow相关

cleanup

代码清理

devops

运维/部署/CI

documentation

文档相关

feature

新功能

frontend

前端相关

question

需要讨论确认

ready

PR CI通过，可合并

refactor

代码重构

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

auto-approve-bot xiaoxia

No Assignees

3 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#1177