# Vite Frontend Bundling 定义 Vite 作为前端构建工具的配置、产出结构和优化策略。 ## Purpose 使用 Vite 的 Rolldown 引擎完成前端打包,实现 code splitting、vendor chunk 分离和 CSS 优化,解决 Bun bundler 前端性能问题。 ## Requirements ### Requirement: Vite 前端构建配置 系统 SHALL 使用 Vite 作为前端构建工具,配置文件位于项目根目录 `vite.config.ts`,以 `src/web` 为 root,产出到 `dist/web/`。 #### Scenario: 运行 Vite 生产构建 - **WHEN** 构建脚本执行 `bunx --bun vite build` - **THEN** Vite SHALL 将 `src/web/index.html` 及其引用的所有模块构建到 `dist/web/` 目录,包含 `index.html` 和 `assets/` 子目录 #### Scenario: 产出文件名包含 content hash - **WHEN** Vite 构建完成 - **THEN** `assets/` 目录下的 JS 和 CSS 文件名 SHALL 包含 content hash(如 `index-a1b2c3.js`) ### Requirement: Code Splitting 策略 系统 SHALL 配置 Vite 的 Rolldown code splitting,将 vendor 库分离为独立 chunks。 #### Scenario: React 相关库分离 - **WHEN** Vite 构建完成 - **THEN** `react`、`react-dom`、`scheduler` SHALL 被打包到名为 `vendor-react` 的独立 chunk #### Scenario: TDesign 相关库分离 - **WHEN** Vite 构建完成 - **THEN** `tdesign-react`、`tdesign-icons-react` 相关模块 SHALL 被打包到名为 `vendor-tdesign` 的独立 chunk #### Scenario: 图表库分离 - **WHEN** Vite 构建完成 - **THEN** `recharts` 和 `d3-*` 相关模块 SHALL 被打包到名为 `vendor-chart` 的独立 chunk ### Requirement: CSS 处理 系统 SHALL 通过 Vite 处理 CSS 导入,产出独立的 CSS 文件。 #### Scenario: CSS 文件产出 - **WHEN** Vite 构建完成 - **THEN** 所有 CSS 导入 SHALL 被提取为独立的 `.css` 文件到 `assets/` 目录 #### Scenario: CSS 压缩 - **WHEN** Vite 执行生产构建 - **THEN** 产出的 CSS 文件 SHALL 经过压缩处理