create-uniapps

🌈 uni-preset-vue 模板说明文档

一个基于 Vue3 + TypeScript + Vite + Pinia + TailwindCSS 的 uni-app 模板，内置多端开发环境配置，支持一键运行微信小程序、H5、App 及各类小程序平台。 本模板旨在快速搭建跨端项目，统一前端开发规范，提高开发效率。

📦 技术栈

🚀 快速开始

1️⃣ 安装依赖

pnpm install
# 或
npm install
# 或
yarn

2️⃣ 启动开发

可根据需要启动不同端的调试模式：

3️⃣ 打包构建

🧩 项目结构

uni-preset-vue/
├── src/
│   ├── pages/           # 页面目录
│   ├── components/      # 公共组件
│   ├── store/           # Pinia 状态管理
│   ├── utils/           # 工具函数与封装
│   ├── locales/         # i18n 国际化配置
│   ├── styles/          # 全局样式与 Tailwind 配置
│   └── main.ts          # 入口文件
│
├── uni_modules/         # uni-app 模块目录
├── static/              # 静态资源
├── package.json
├── vite.config.ts
├── tsconfig.json
└── README.md

🧠 开发规范

代码规范

• 使用 TypeScript 编写逻辑。

• 使用 ESLint + Prettier + Tailwind 进行自动格式化。

• 提交前执行：

  npm run type-check
  

  确保类型检查通过。

目录规范

• 页面统一放在 src/pages/
• 公共组件放在 src/components/
• 全局状态放在 src/store/
• 工具函数放在 src/utils/
• 样式配置统一放在 src/styles/

🧰 常用依赖说明

🧪 检查与优化

🌍 支持平台

💡 开发建议

1. 推荐使用 VSCode 搭配以下插件：

   • 🌟 Volar（Vue 3 支持）
   • 🌟 ESLint
   • 🌟 Tailwind CSS IntelliSense
   • 🌟 Iconify IntelliSense

2. 若需自定义端平台启动，请修改 package.json 中的 scripts 命令。

3. 统一风格建议使用 prettier-plugin-tailwindcss 自动调整类名顺序。

🧾 License

本项目模板仅供学习与快速开发使用。 如需商用或二次封装，请保留原作者说明或在适当位置注明出处。

👨‍💻 作者信息

• 作者：josef
• 模板名称：uni-preset-vue
• 创建时间：2025年
• 版本：v1.0.0

📅 更新日志