描述:无 UI 框架依赖,可以无缝接入自己喜欢的 UI 框架使用
-
当前项目要求已安装
18.0或更高版本的Node.js -
每个文件夹目录的
README.md都带有具体的说明,注意查看! 注意查看! 注意查看! -
因为项目工程的依赖包极少,所以可以随时升级某个依赖包,无需担心不匹配问题;同样,无论你是用
npm、pnpm、yarn都是可以成功运行的。
| 分支 | 演示地址 | 所用技术 | 补充/说明 |
|---|---|---|---|
| master | 预览 | vite 8.x、vue 3.x、vue-router 5.x、typescript | vue3 版本,无引用任何 UI 框架 |
| el-plus | 预览 | vite 8.x、vue 3.x、vue-router 5.x、typescript、element-plus | 基于master加入了 UI 框架的配置使用,并增加了 curd 低代码功能 |
| 功能 | 描述 & 说明 |
|---|---|
| layout-核心布局 | 详细说明 |
| 路由配置和权限使用 | 当前有 静态 和 动态 路由两种配置,详细说明 |
| http-网络请求 | 直接使用原生封装的一个工具函数,详细说明 |
| 状态管理 | 自行设计的一套管理方式,不限框架使用,详细说明 |
| svg-图标 | 使用异步远程加载:详细说明 |
| 常用工具函数 | 在 src/utils/index.ts 中内置了一些使用频率极高的工具函数:类型判断、日期格式化、文本复制、深拷贝等。 |
当前模板只提供必需的功能,功能模块之间尽可能保证低耦合性,这对所有开发者都是一件非常有利的事情,例如你无需担心替换、修改某一功能时影响到其他。另外更为重要的是:当前所有已实现功能都不依赖任何第三方库,这意味着你可以无需关心package.json的依赖版本,因为根本就没有其他依赖,所以根据自己的喜好去引入第三方库的时候会非常舒服。
像前端工程化配置ESLint、styleLint、git-husky等这类开发约束工具这里没有使用,理由有以下几点:
-
规则的东西不适用作为通用型项目,因为有很多自由开发者、初学者、后端开发者等,他们在使用时并不需要,这些工具只会使其在初次接触中变得束手无策,所以这违背了我写这个项目的初衷。
-
其次就是这些约束工具对开发效率的提升并不大,只不过是将代码格式化得好看而已;我始终认为代码质量由编码水平决定而不是约束工具。
-
代码约束的工具运行时会占用内存,在一些电脑性能不那么高的设备上会出现卡顿,这使得开发过程十分笨重。更重要的是,有时候过多的工具检测报错会导致进程崩溃,尽管你的代码可以正常运行。
Tips: 在package.json中,vue-tsc不是必需的,需要提高构建速度可以自行卸载该依赖,并在构建命令中删除对应vue-tsc --noEmit &&代码。但不建议这样做,因为在开发时会失去ts的全局代码检查。在官方的默认脚手架中,tsc是放在build中运行,这样的操作其实非常不利于排查问题,如果项目是放在远程或者其他服务器中进行构建,那么在build的过程中因为类型校验而不通过,对开发者来说,通过日志去排查问题的方式非常耗时,所以将tsc放在开发环境中才是比较合理的。
#安装依赖
npm install
# 运行项目
npm run dev
# 构建项目
npm run build