cloud-template

cloud-template vite + vue3 + ts^(极速)

在线预览

简体中文 | English

🐳 特性

• ⚡️ Vue 3, Vite, pnpm

• 📦 组件自动导入

• 🍍 通过 Pinia 进行状态管理

• 🎨 UnoCSS - 即时按需原子化 CSS 引擎

• 😃 通过类名使用任意图标集的图标

• 📥 API 自动导入 - 直接使用 Composition API 等

• 🦾 API 封装 - 基于 [axios] 的简单封装

• 🔍 oxlint - 基于 Rust 的超快速 JavaScript/TypeScript 代码检查工具

• 🎨 Element Plus - Vue 3.0 UI 组件库

• 🚀 自动版本更新并生成 CHANGELOG

• 🎨 Lottie - 用于解析 After Effects 动画的 JavaScript 库

• 📊 Echarts - 在 Vue 中使用 Echarts

• 📊 Utils-@iceywu/utils - 一套通用工具函数集合

• 🌐 i18n - 国际化支持

• 🎨 shadcn/ui - 基于 Radix Vue 和 Tailwind CSS 构建的可复用组件

🚀 代码质量与性能

构建工具

• Rolldown-Vite - 基于 Rust 的下一代打包工具，提供显著更快的构建时间和热重载

代码检查

• oxlint - 基于 Rust 编写的超快速 JavaScript/TypeScript 代码检查工具
• ESLint - 传统代码检查，配合 eslint-plugin-oxlint 实现无缝集成
• 双重检查策略: oxlint 提供极速检查 + ESLint 提供全面规则覆盖

脚本命令

# 运行所有代码检查
bun run lint

# 仅运行 oxlint（最快）
bun run lint:oxlint

# 仅运行 ESLint
bun run lint:eslint

# 自动修复问题
bun run lint:fix

动机

为什么要做这个模板？

1. 节省下次开发时浪费在配置上的时间
2. 结合主流插件，整合现代开发架构，提高开发效率

灵感来源

该模板受 tov-template 启发

使用方法

开发

运行以下命令并访问 http://localhost:5173/

pnpm dev

构建

构建应用，运行

pnpm build

预览

预览构建结果

pnpm preview

代码检查

# 检查代码规范
pnpm lint

# 自动修复代码问题
pnpm lint:fix

类型检查

pnpm typecheck

测试

# 运行测试
pnpm test

# 运行测试覆盖率
pnpm coverage

项目结构

cloud-template/
├── public/                 # 静态资源
├── src/
│   ├── api/               # API 接口
│   ├── assets/            # 资源文件
│   ├── components/        # 组件
│   ├── composables/       # 组合式函数
│   ├── layouts/           # 布局
│   ├── pages/             # 页面
│   ├── plugins/           # 插件
│   ├── stores/            # 状态管理
│   ├── styles/            # 样式
│   ├── utils/             # 工具函数
│   └── main.ts            # 入口文件
├── .oxlintrc.json         # oxlint 配置
├── eslint.config.js       # ESLint 配置
├── uno.config.ts          # UnoCSS 配置
└── vite.config.ts         # Vite 配置

配置说明

代码检查配置

项目使用双重代码检查策略：

1. oxlint: 提供极速的基础代码检查
2. ESLint: 提供更全面的代码规范检查

通过 eslint-plugin-oxlint 自动禁用重复规则，避免冲突。

构建工具

使用 rolldown-vite 替代传统 Vite，基于 Rust 实现，提供：

• 更快的冷启动时间
• 更快的热重载
• 更快的生产构建

许可证

MIT License © 2023 IceyWu