# UniApp-X-Basic **Repository Path**: kcons/uni-app-x-basic ## Basic Information - **Project Name**: UniApp-X-Basic - **Description**: UniApp-X-Basic：一款基于UniApp-X 骨架模板，是一款开箱即用、面向真实企业级场景的 UniApp 开发脚手架，深度整合全场景业务所需的成熟工具封装、规范架构与通用业务模块，彻底解决开发者从零搭建项目、重复封装工具、适配多端兼容等痛点，让你专注核心业务逻辑，大幅提升开发效率，轻松实现新项目快速落地与存量项目高效二次开发。 - **Primary Language**: TypeScript - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2026-03-20 - **Last Updated**: 2026-03-30 ## Categories & Tags **Categories**: Uncategorized **Tags**: uni-app, vue3, TypeScript, uniapp-x ## README # UniApp-X-Basic _________________________________________________________________________________________________________________________________________________________________________________________ ### 介绍 UniApp-X-Basic：一款基于 UniApp-X 骨架模板，是一款开箱即用、面向真实企业级场景的 UniApp 开发脚手架，深度整合全场景业务所需的成熟工具封装、规范架构与通用业务模块，彻底解决开发者从零搭建项目、重复封装工具、适配多端兼容等痛点，让你专注核心业务逻辑，大幅提升开发效率，轻松实现新项目快速落地与存量项目高效二次开发。 ### 项目特性 - **开箱即用**：基于 UniApp-X 骨架模板，提供完整的项目结构 - **企业级架构**：规范的项目架构，适合企业级应用开发 - **丰富组件库**：内置多种公共基础 UI 组件和业务组件 - **工具封装**：集成请求封装等常用工具类 - **多端适配**：支持多端运行 ### 项目结构 ``` UniApp-X-Basic/ ├── manifest.json # App 基础配置（appid、版本、Android/iOS 最低版本） ├── pages.json # 路由 + tabbar 配置 ├── App.uvue # 应用入口，全局引入 4 个 CSS 文件 ├── main.uts # createSSRApp 启动入口 ├── index.html # index页面 │ ├── common/ # 全局样式目录 │ ├── uni.css # UniApp 初始化/重置样式（消除平台差异） │ ├── main.css # 全局原子 CSS（flex/文字/间距/颜色/圆角等 100+ 工具类） │ ├── icon.css # iconfont 字体图标 │ └── common.css # 用户自定义全局样式（卡片/按钮/表单/列表等组件级样式） │ ├── components/ # 组件目录 │ ├── common/ # 公共基础 UI 组件（含使用说明） │ ├── global/ # easycom 全局自动导入组件（含 pages.json 配置示例） │ └── pages/ # 页面专属子组件 │ ├── pages/ # 页面目录 │ ├── tabbar/ │ │ ├── home.uvue # 首页（Banner + 功能入口 + 列表示例） │ │ └── mine.uvue # 我的（用户信息头部 + 菜单 + 退出登录） │ └── account/ │ ├── login.uvue # 登录页 │ └── register.uvue # 注册页 │ ├── static/ # 静态资源目录 │ ├── fonts/ # iconfont.ttf 存放处 │ ├── images/ # 公共图片（logo、默认头像等） │ ├── tabbar/ # tabbar 图标 │ └── pages/home/ # 首页专属静态资源 │ └── utils/ # 工具函数目录 └── request/ # 请求封装库 └── index.uts # 网络请求封装 ``` ### 快速开始 1. **环境要求** - HBuilderX 3.x 或更高版本 - Node.js 14.x 或更高版本 2. **安装依赖** ``` npm install ``` 3. **运行项目** - 使用 HBuilderX 打开项目 - 选择运行到对应平台 ### 页面说明 | 页面 | 路径 | 说明 | |------|------|------| | 首页 | `/pages/tabbar/home` | Banner + 功能入口 + 列表示例 | | 我的 | `/pages/tabbar/mine` | 用户信息头部 + 菜单 + 退出登录 | | 登录 | `/pages/account/login` | 登录页面 | | 注册 | `/pages/account/register` | 注册页面 | ### 组件使用 项目内置了丰富的公共组件，位于 `components/` 目录下： - **公共基础组件** (`components/common/`)：可复用的基础 UI 组件 - **全局组件** (`components/global/`)：通过 easycom 自动导入 - **页面专属组件** (`components/pages/`)：特定页面使用的组件 ### 样式说明 全局样式文件位于 `common/` 目录： - `uni.css`：UniApp 初始化样式，消除平台差异 - `main.css`：原子 CSS 类，包含 flex、文字、间距、颜色、圆角等 100+ 工具类 - `icon.css`：字体图标样式 - `common.css`：自定义全局样式，包含卡片、按钮、表单、列表等组件级样式 ### 请求封装 项目已集成网络请求封装，位于 `utils/request/index.uts`，可直接导入使用： ```typescript import request from '@/utils/request/index.uts' ``` ### 许可证 本项目基于 MIT 许可证开源。 ---

Gitee Star Gitee Fork