@huoye/uni-cli

按需生成 uni-app 项目的脚手架工具。你不要的功能，连一行代码都不会出现。

特性

• 代码级裁剪 — 不是删文件，是精确删除不需要的 import、组件、逻辑块
• 零残留 — 生成的代码没有任何标记痕迹，像手写的一样干净
• 按需组合 — 功能模块自由选择，2^N 种组合只维护 1 份模板
• 依赖感知 — 功能之间有依赖关系时自动处理，不让你踩坑
• 智能缓存 — 首次自动下载模板，后续秒级创建

快速开始

# 使用 npx（推荐，无需安装）
npx @huoye/uni-cli my-app

# 或全局安装
npm install -g @huoye/uni-cli
hy-uni my-app

CLI 会引导你选择功能模块：

| 模块 | 说明 | |------|------| | 网络请求层 | 基于 uni.request 的 HTTP 客户端、请求拦截、错误处理 | | 主题管理 | 亮色/暗色切换、自定义主色调 | | 业务示例 | API 调用、表单、列表等完整示例页面 |

选完确认，项目就生成了：

cd my-app
pnpm install
pnpm dev:h5       # H5 开发
pnpm dev:mp       # 微信小程序开发

跟其他脚手架有什么不同？

大多数脚手架的"功能选择"只是选模板变体，或者删文件夹。@huoye/uni-cli 做到了代码行级别的裁剪：

// 模板源码中的标记（用户不会看到）
export * from './modules/app'
export { useThemeStore } from './theme' // 【theme】
export { useCounterStore } from './modules/counter' // 【examples】

• 不选 theme → useThemeStore 这行消失，标记也消失
• 选了 theme → 保留代码，标记自动去掉

支持块级裁剪和反向标记，详见博客文章。

生成项目的技术栈

• Vue 3 + TypeScript — 类型安全
• Vite — 毫秒级热更新
• uni-app — 一套代码，多端运行
• UnoCSS — 原子化 CSS
• Pinia — 状态管理
• ESLint — 代码规范开箱即用

命令参考

# 交互式创建
hy-uni

# 指定项目名
hy-uni my-app

# 更新模板缓存
hy-uni update

参与贡献

请阅读 CONTRIBUTING.md。

许可证

MIT