littlebot
Published on 2025-04-08 / 0 Visits
0

【源码】基于 Vite + Vue3 + TypeScript 的现代 Web 开发模板

项目简介

此项目是一个基于 Vite、Vue3 和 TypeScript 的开箱即用现代开发模板。整合众多实用功能与配置,能帮助开发者节省项目配置时间,以更现代的方式开发 Web 应用,提高开发效率。

项目的主要特性和功能

  1. 构建与框架:采用 Vite 构建工具,结合 Vue3 框架,支持 TypeScript 开发。
  2. 路由与布局:有文件路由,目录结构即路由;具备布局系统,支持默认和非默认布局。
  3. 模拟与请求:支持 Mock 数据,可在开发环境模拟后端接口;提供 SWR 请求方式,用 vue - request 库简化请求处理;封装全局通用的 axios 请求。
  4. 自动引入:实现 Api、组件、图标自动引入,减少手动 import 操作。
  5. 状态管理:使用 pinia 进行状态管理,替代 vuex。
  6. 样式与模式:支持 unocss 原子 CSS 库,简化样式编写;具备暗黑模式切换功能。
  7. 开发辅助:提供跳转进度条、开发面板;支持插件自动加载;具备 Vitest 单元测试及报告生成;支持 Markdown 渲染;提供路径别名;支持命令行自动创建与删除模块或组件。
  8. 国际化与错误处理:支持 i18n 国际化;提供漂亮的 404 页面。
  9. 其他特性:支持 tsx 文件;具备 gzip 资源压缩;支持环境变量配置;统一代码规范与风格;自动移除生产环境开发日志;支持 defineOptions;集成 echarts 用于图表展示;提供全局通用 toast 通知;自动生成环境变量类型声明;使用 renovate 自动更新依赖;自动更新版本并生成 CHANGELOG;提供最快最小的 dockerfile 静态 go 服务。

安装使用步骤

前提条件

建议使用 node 当前的长期维护版本 v18,且仅支持 pnpm 包管理器,可参考 安装教程 进行安装。

复制模板

  • Giteegit clone git@gitee.com:dishait/tov-template.git

项目操作

  1. 安装依赖pnpm install
  2. 开发
    • 启动开发环境:pnpm dev
    • 开启 host:pnpm dev:host
    • 自动打开浏览器:pnpm dev:open
  3. 预览
    • 预览项目:pnpm preview
    • 开启 host:pnpm preview:host
    • 自动打开浏览器:pnpm preview:open
  4. 打包
    • 常规打包:pnpm build
    • 调试打包:pnpm build:debug
  5. 单元测试
    • 执行单元测试:pnpm test
    • 生成单元测试报告:pnpm coverage
  6. 类型检查pnpm typecheck
  7. 自动创建pnpm auto:create
  8. 自动移除pnpm auto:remove
  9. 依赖更新
    • 更新依赖版本:pnpm deps:fresh
    • 重新安装依赖:pnpm i
  10. 代码规范校验
    • 执行校验:pnpm lint
    • 校验并修复:pnpm lint:fix

下载地址

点击下载 【提取码: 4003】【解压密码: www.makuang.net】