如果你还在为 uni-app 的开发体验而苦恼,还在 HBuilderX 的黑盒中挣扎,那么这篇文章绝对值得你花 5 分钟阅读。
前言:uni-app 开发的痛点
作为跨端开发的热门选择,uni-app 让我们能够"一套代码,多端运行"。但在实际开发中,你是否遇到过这些问题:
- HBuilderX 编辑器体验一般:语法提示不够智能,插件生态有限
- 调试困难:黑盒性质让问题排查变得复杂
- 生态割裂:uni_modules 生态远不如 npm 生态繁荣
- 工具链落后:缺乏现代前端开发工具的支持
如果你正在为这些问题头疼,那么 Wot Demo 项目将是你的救星!
Wot Demo:现代化 uni-app 开发模板
Wot Demo 是一个基于 vitesse-uni-app 深度整合 Wot UI 组件库的 uni-app 快速启动模板,采用直观且可扩展的方式创建类型安全、高性能和生产级的跨端应用。你可以直接开始编写 .vue 文件,而无需从头开始配置。
主要依赖
vitess-uni-app 主要由以下开源包组成:
- 核心:@uni-helper
- 引擎:uni-app
- 打包器:Vite
- CSS 样式:UnoCSS
- 代码质量:ESLint 和 TypeScript
wot-demo 在以上开源包的基础上引入了以下开源包:
- 组件库:Wot UI
- CI/CD:uni-mini-ci
- 路由:uni-mini-router
- 网络请求:Alova
- Pinia:Pinia
当然,如果你希望使用一个相对纯净的启动模板, vitesse-uni-app 是一个绝佳选择。此外,仍可以使用 create-uni 自行搭建启动模板。
🎯 项目定位
- 告别 HBuilderX:拥抱 VS Code + 现代前端工具链
- 开箱即用:集成了完整的开发环境和最佳实践
- 生产就绪:从开发到部署的完整解决方案
核心特性:为现代开发而生
1. 🎨 Wot UI:高颜值组件库
Wot UI 是项目的核心亮点,提供了:
- 70+ 高质量组件:覆盖移动端主流场景
- 多平台支持:微信小程序、支付宝小程序、H5、APP
- Vue 3 + TypeScript:现代化技术栈
- 主题定制:支持暗黑模式和自定义主题
- 国际化支持:内置 15 种语言包
<!-- 示例:使用 Wot UI 组件 -->
<template>
<wd-button type="primary" @click="handleClick">
点击按钮
</wd-button>
</template>
2. 📦 Uni Helper:开发体验加速器
集成 Uni Helper:uni-helper.js.org/ 系列插件,开发体验飞速提升:
- 语法支持:完整的 TypeScript 类型提示
- 自动导入:组件和 API 自动导入
- 构建优化:针对 uni-app 的构建优化
3. 🛠️ 现代化开发工具链
TypeScript + ESLint
- 类型安全:编译时发现问题,降低运行时错误
- 代码质量:ESLint 规则保障代码规范
- 智能提示:VS Code + Volar 提供完整的开发体验
Vite 构建系统
- 极速启动:冷启动时间大幅缩短
- 热更新:修改代码立即看到效果
- 现代化打包:基于 ES 模块的高效构建
UnoCSS 原子化 CSS
<!-- 跨平台样式支持 -->
<view class="flex justify-center items-center p-4 uni-h5:bg-red uni-mp:bg-blue">
内容区域
</view>
4. 🚦 uni-mini-router:Vue Router 般的路由体验
告别 uni-app 原生路由的繁琐,享受 Vue Router 的开发体验:
// 编程式导航
const router = useRouter()
// 路由跳转
router.push('/pages/detail/index')
// 带参数跳转
router.push({
name: 'detail',
params: { id: '123' },
query: { tab: 'info' }
})
// 路由守卫
router.beforeEach((to, from, next) => {
if (to.meta.requiresAuth && !isLoggedIn()) {
next({ name: 'login' })
} else {
next()
}
})
5. 🌐 Alova:极致高效的请求工具
不再为网络请求头疼,Alova 提供:
- 声明式请求:简化 API 调用
- 智能缓存:提升应用性能
- 请求/响应拦截:统一处理业务逻辑
快速上手:3 分钟启动项目
在线体验
想要快速体验?直接访问在线编辑器:
- StackBlitz 在线编辑:stackblitz.com/github/Moon…
- GitHub 模板:github.com/Moonofweish…
本地安装
环境要求:
- Node.js >= 18.19.0
- VS Code + Volar 插件
一键创建项目:
# 使用 create-uni 创建
pnpm create uni my-project -t wot-demo
# 或使用 degit
pnpx degit Moonofweisheng/wot-demo my-project
# 安装依赖
cd my-project
pnpm install
# 启动开发服务器
pnpm dev
跨端开发:
# H5 开发
pnpm dev
# 微信小程序
pnpm dev:mp-weixin
# 支付宝小程序
pnpm dev:mp-alipay
# APP
pnpm dev:app
为什么选择 Wot Demo?
1. 开发体验提升 10 倍
- VS Code 智能提示
- 热重载快速预览
- TypeScript 类型安全
- 现代化调试工具
2. 生产级质量保证
- 完整的代码规范
- 自动化测试支持
- CI/CD 集成
- 性能优化
3. 丰富的生态支持
- 100000+ 图标库 (Icones:icones.js.org/)
- 完善的文档和示例
- 活跃的社区支持
- 持续的版本更新
4. 学习成本低
- 基于 Vue 3 生态
- 渐进式增强
- 详细的文档说明
- 最佳实践指导
生态与社区
相关项目推荐
- Wot Demo:本文主角,地址:github.com/Moonofweish…
- vitesse-uni-app:由 Vite & uni-app 驱动的跨端快速启动模板,地址:github.com/uni-helper/…
- Wot UI:Wot UI,地址wot-design-uni.cn/
- uni-mini-ci:小程序 CI/CD 插件,地址:github.com/Moonofweish…
- uni-mini-router:小程序路由库,地址:github.com/Moonofweish…
- alova:极致高效的请求工具集,地址:alova.js.org/zh-CN/
- unibest:另一个优秀的 uni-app 模板,地址:github.com/unibest-tec…
获取帮助
- 📖 官方文档: demo.wot-design-uni.cn/
- 💬 Discussions 讨论区: github.com/Moonofweish…
- 👥 微信交流群: wot-design-uni.cn/guide/join-…
项目展望与贡献
未来规划
- 更多行业模板
- 完善的测试覆盖
- 更多平台适配
- 性能持续优化
如何贡献
项目采用 MIT 开源协议,欢迎大家:
- 🐛 提交 Issue 报告问题
- 🔧 提交 PR 贡献代码
- 📝 完善文档说明
- ⭐ Star 支持项目
总结
Wot Demo 不仅仅是一个项目模板,它更带来了:
✅ 告别过时的开发方式:拥抱现代前端工具链
✅ 提升开发效率:类型安全 + 智能提示 + 热重载
✅ 保证项目质量:最佳实践 + 代码规范 + 自动化测试
✅ 降低学习成本:基于熟悉的 Vue 生态
如果你正在开发 uni-app 项目,或者准备开始一个新的跨端项目,不妨试试 Wot Demo。相信它会让你的开发体验焕然一新!
🔗 相关链接:
- 项目地址:github.com/Moonofweish…
- 在线体验:demo.wot-design-uni.cn/
- Wot UI 组件库:wot-design-uni.cn/
💡 如果这篇文章对你有帮助,别忘了点赞支持!有任何问题欢迎在评论区讨论~
🔥 更多信息请关注我的微信公众号【阿鱼聊前端】