create-vzan-web-cli

vue3 + vite + ts + pnpm + biome + axios + husky + lint-staged + pinia + vue-router + tailwind 通用项目脚手架。

使用

# 交互式生成
npx create-vzan-web-cli my-app
# 等价于
npx create vzan-web-cli my-app

# 全默认(不交互)
npx create-vzan-web-cli my-app -y

# 跳过装依赖/初始化 git
npx create-vzan-web-cli my-app --skip-install --skip-git

# 指定包管理器
npx create-vzan-web-cli my-app --pm pnpm

模板特性

• 4 套环境 dev/test/pre/prod：env/ 下 serve-/build- 共 8 个文件，VITE_APP_ENV 驱动
• axios 二次封装（src/utils/http/）
  • 请求拦截：自动注入 token / buid / reqid，过滤空值
  • 响应拦截：成功返回 res.data，错误走重试，报错一律 console.error（不依赖任何 UI 库）
  • 失败自动重试：config.retry = { retryCount, retryDelay, backupUrls[] }，主链重试完切备用链接
  • Promise 缓存：createCacheRequest({ timeout?, sameArgs?, requestFn? })，x 秒内多次调用只发一次；不传 timeout = 永久缓存
• baseUrl 独立维护：src/utils/baseUrl.ts 多网关写法，按环境动态拼后缀
• pinia / vue-router(history) / tailwind v4 / lodash-es / qs

本仓库开发

pnpm install              # 装脚手架自身依赖
pnpm dev:template         # 跑 template 子工程
pnpm build:template       # 构建 template 子工程
node bin/cli.js test-app  # 本地试跑生成