site-vue/README.md

项目技术栈文档

项目概述

项目名称: 云·企业官网 版本: 1.10.1
项目类型: Vue 3 + TypeScript 前端管理框架 构建工具: Vite 3.x

核心技术栈

前端框架

• Vue 3.5.3 - 渐进式 JavaScript 框架
• TypeScript 4.8.2 - JavaScript 的超集，提供静态类型检查
• Vite 3.0.9 - 下一代前端构建工具

UI 组件库

• Ant Design Vue 3.2.11 - 企业级 UI 设计语言和组件库
• @ant-design/icons-vue 6.1.0 - Ant Design 图标库
• @ant-design/colors 6.0.0 - Ant Design 色彩系统

状态管理与路由

• Pinia 2.0.21 - Vue 3 官方推荐的状态管理库
• Vue Router 4.1.5 - Vue.js 官方路由管理器

样式处理

• Less 4.1.3 - CSS 预处理器
• TailwindCSS 3.4.6 - 实用优先的 CSS 框架
• PostCSS 8.4.39 - CSS 后处理器
• Autoprefixer 10.4.19 - CSS 自动添加浏览器前缀

国际化

• Vue I18n 9.2.2 - Vue.js 国际化插件

数据可视化

• ECharts 5.3.3 - 百度开源的数据可视化库
• Vue-ECharts 6.2.3 - ECharts 的 Vue 3 组件
• echarts-wordcloud 2.0.0 - ECharts 词云插件
• @antv/g2 5.1.22 - 蚂蚁金服数据可视化语法

富文本编辑器s

• TinyMCE 5.10.5 - 富文本编辑器
• ByteMD 1.17.2 - Markdown 编辑器
• md-editor-v3 5.2.3 - Vue 3 Markdown 编辑器

工具库

• Axios 0.27.2 - HTTP 客户端
• Lodash-es 4.17.21 - JavaScript 实用工具库
• Day.js 1.11.5 - 轻量级日期处理库
• Crypto-js 4.2.0 - 加密库
• js-cookie 3.0.5 - Cookie 操作库
• js-md5 0.7.3 - MD5 加密库
• mitt 3.0.1 - 事件总线
• nprogress 0.2.0 - 页面加载进度条

文件处理

• ExcelJS 4.3.0 - Excel 文件处理
• XLSX 0.18.5 - 电子表格文件处理
• ali-oss 6.18.0 - 阿里云对象存储

交互增强

• SortableJS 1.15.0 - 拖拽排序库
• vuedraggable 4.1.0 - Vue 拖拽组件
• CropperJS 1.5.12 - 图片裁剪库
• CountUp.js 2.3.2 - 数字动画库
• JSBarcode 3.11.5 - 条形码生成库

地图服务

• @amap/amap-jsapi-loader 1.0.1 - 高德地图 JS API 加载器

实时通信

• socket.io-client 4.7.1 - WebSocket 客户端

视频播放

• xgplayer 2.31.7 - 西瓜视频播放器

企业微信

• @wecom/jssdk 1.3.1 - 企业微信 JS SDK

开发工具配置

代码质量

• ESLint 8.23.0 - JavaScript/TypeScript 代码检查工具
• Prettier 2.7.1 - 代码格式化工具
• @typescript-eslint/eslint-plugin 5.36.1 - TypeScript ESLint 插件
• eslint-plugin-vue 9.4.0 - Vue ESLint 插件

构建优化

• @vitejs/plugin-vue 3.0.3 - Vite Vue 插件
• @vitejs/plugin-legacy 2.0.1 - 传统浏览器兼容性插件
• vite-plugin-compression 0.5.1 - Gzip 压缩插件
• unplugin-vue-components 0.22.4 - 组件自动导入插件
• terser 5.15.0 - JavaScript 压缩工具

类型支持

• @types/node 18.7.14 - Node.js 类型定义
• @types/lodash-es 4.17.6 - Lodash 类型定义
• @types/nprogress 0.2.0 - NProgress 类型定义
• @types/sortablejs 1.13.0 - SortableJS 类型定义

项目结构

src/
├── components/          # 公共组件
├── config/             # 配置文件
├── layout/             # 布局组件
├── styles/             # 样式文件
├── utils/              # 工具函数
├── App.vue             # 根组件
└── main.ts             # 入口文件

构建配置

Vite 配置特性

• 路径别名配置 (@/ 指向 src/)
• 组件按需导入
• Gzip 压缩
• Less 预处理器支持
• 动态主题支持
• 构建优化配置

TypeScript 配置

• 严格模式启用
• ES Next 目标
• 路径映射支持
• 装饰器支持

开发命令

# 开发环境启动
npm run dev

# 生产环境构建
npm run build

# 代码检查
npm run lint:eslint

# 清理缓存
npm run clean:cache

# 清理依赖
npm run clean:lib

# 构建 CSS
npm run build-css

浏览器兼容性

• 目标浏览器: Chrome 63+
• 支持现代浏览器特性
• 通过 Vite Legacy 插件支持旧版浏览器

特色功能

1. 组件按需导入 - 减少打包体积
2. 动态主题 - 支持主题切换
3. 国际化支持 - 多语言切换
4. 丰富的数据可视化 - 多种图表组件
5. 完整的文件处理 - 支持 Excel、图片等文件操作
6. 企业级功能 - 权限管理、工作流等

---

文档生成时间: 2024年