什么是 Weapp-vite ?

核心简介

weapp-vite 是一个面向微信小程序的现代构建框架：在保留原生小程序开发体验的同时，引入 Vite 生态、TypeScript、CSS 预处理器以及更高效的开发和构建流程。你可以继续使用微信官方的语法与目录结构，却能享受到热更新、按需编译、自动化脚手架等现代能力。

我们想解决的问题

• 原生工具链缺乏现代化体验：缺少模块化、自动刷新、类型提示等开发效率工具。
• 跨端框架对小程序进行抽象，虽然功能丰富，但学习成本高、调试链路长，并不适合想坚持原生写法的团队。
• 现有老项目常见的 gulp、自研脚本难以维护，升级依赖或引入工程化手段成本高。

Weapp-vite 的能力亮点

• 原生写法 0 改动：保留微信原生语法和目录组织方式，逐步引入现代能力。
• Vite/Rolldown 生态：兼容 Vite 配置与插件，底层打包器 Rolldown 针对小程序场景做了分包、样式注入等优化。
• 工程化开箱即用：默认支持 TypeScript、PostCSS、Sass/Less、Tailwind CSS、JSONC 等常用特性，并提供 pnpm create weapp-vite 和 pnpm g 等脚手架命令。
• 小程序特色增强：自动构建 miniprogram_npm、智能分包依赖分析、自动组件注册、WeChat Developer Tools CLI 集成。
• 良好的调试体验：保存即热更新、详细的构建日志、weapp.debug 钩子帮助排查路径解析、产物归属等问题。

什么时候适合选择 Weapp-vite

• 你想坚持原生小程序写法，同时希望获得现代前端工具链（TS、模块化、热更新等）。
• 团队中已有老项目，想在不动业务代码的情况下升级构建脚本。
• 需要深入使用微信提供的底层能力（如 Skyline、Donut），对运行时兼容层持谨慎态度。

什么时候可以考虑其他方案

• 项目需要“一套代码多端运行”，或想直接使用 Vue、React 写界面时，可以优先评估 uni-app、taro 等跨端框架。
• 如果你只需简单的构建能力且已投入其他脚手架，可以先续用现有方案，再择机迁移。

迁移与生态

• weapp-vite init 支持在现有原生项目上直接生成配置，沿用原目录结构即可。
• 构建产物完全兼容微信开发者工具，分包、插件、Worker 等官方能力都可以继续使用。
• 通过 Vite 插件体系可以快速接入 Tailwind CSS、UnoCSS、自动化测试、Rollup 插件等生态资源。

想要快速验证效果？前往 快速开始 章节，十分钟内完成首个项目的创建、运行与调试。