feat: 初始化工程

This commit is contained in:
2026-08-20 15:26:19 +08:00
commit c099e4a743
659 changed files with 113041 additions and 0 deletions

View File

@@ -0,0 +1,129 @@
# uni-app-x CLI 命令模板
## 官方文档
参考官方文档https://uniapp.dcloud.net.cn/quickstart-cli.html
## 项目创建命令
### 使用官方模板
```bash
# 创建项目
npx degit dcloudio/uni-preset-vue-x my-project
# 或使用官方脚手架
npm create uni-app-x@latest my-project
```
### 使用 HBuilderX
1. 文件 → 新建 → 项目
2. 选择 **uni-app x**
3. 选择模板
4. 填写项目信息
5. 点击创建
## 项目运行命令
### 开发环境
```bash
# H5 平台
npm run dev:h5
# 微信小程序
npm run dev:mp-weixin
# App需要 HBuilderX
npm run dev:app
```
### 生产环境
```bash
# H5 平台
npm run build:h5
# 微信小程序
npm run build:mp-weixin
# App需要 HBuilderX
npm run build:app
```
## 常用命令
### 安装依赖
```bash
npm install
```
### 类型检查
```bash
# TypeScript 类型检查
npm run type-check
# 或使用 tsc
npx tsc --noEmit
```
### 代码检查
```bash
# ESLint 检查
npm run lint
# 自动修复
npm run lint:fix
```
## 一键创建项目脚本
```bash
#!/bin/bash
# create-uniappx-project.sh
PROJECT_NAME=$1
if [ -z "$PROJECT_NAME" ]; then
echo "Usage: ./create-uniappx-project.sh <project-name>"
exit 1
fi
echo "Creating uni-app-x project: $PROJECT_NAME"
npx degit dcloudio/uni-preset-vue-x $PROJECT_NAME
cd $PROJECT_NAME
npm install
echo "Project created successfully!"
echo "Run 'npm run dev:h5' to start development server"
```
## 项目初始化完整流程
```bash
# 1. 创建项目
npx degit dcloudio/uni-preset-vue-x my-project
# 2. 进入项目目录
cd my-project
# 3. 安装依赖
npm install
# 4. 初始化 Git可选
git init
git add .
git commit -m "Initial commit"
# 5. 运行项目
npm run dev:h5
```
## 参考资源
- uni-app-x 文档https://doc.dcloud.net.cn/uni-app-x/
- TypeScript 文档https://www.typescriptlang.org/
- Vite 文档https://cn.vitejs.dev/