用途
本技能用于创建新的 uni-app 项目。当用户希望从零创建 uni-app 项目、初始化项目结构与配置文件、搭建 uni-app 开发环境、生成不同配置的项目模板、配置 manifest.json 和 pages.json、创建 uni-app 页面与组件，或使用 HBuilderX / CLI 搭建项目时，均可使用该技能。
主要能力
- 通过官方 CLI 或 HBuilderX 创建 uni-app 项目。
- 支持 Vue 2 / Vue 3 模板选择。
- 生成项目结构及相应配置文件。
- 配置 manifest.json 与 pages.json。
- 创建 uni-app 页面和组件。
- 支持“一句话创建”的单命令创建方式。
使用方式
- 根据用户请求识别项目类型：
- 标准 uni-app 项目 → 使用 Vue 2 或 Vue 3 模板；
- HBuilderX 项目 → 使用 HBuilderX 创建方式；
- CLI 项目 → 使用 Vue CLI 或官方 CLI 命令。
- 从 examples/guide/ 目录加载相应示例文件：
- examples/guide/installation.md：安装与环境搭建；
- examples/guide/quick-start.md：快速开始指南；
- examples/guide/project-types.md：不同项目类型与模板。
- 从 templates/ 目录加载相应模板文件：
- templates/project-templates.md：项目结构模板；
- templates/cli-commands.md：CLI 命令模板。
- 按照这些文件中的具体说明完成项目创建、结构与配置。
- 生成包含正确文件与配置的项目结构。
适用场景
- 从零创建 uni-app 项目。
- 初始化 uni-app 项目结构与配置文件。
- 搭建 uni-app 开发环境。
- 生成不同配置的项目模板。
- 配置 manifest.json 和 pages.json。
- 创建 uni-app 页面与组件。
- 使用 HBuilderX 或 CLI 搭建 uni-app 项目。
限制与注意事项
- 本技能聚焦于 uni-app CLI 快速开始与 HBuilderX 创建流程。
- 当用户需要“一句话创建”时，使用单命令创建方式。
- 需确保 Vue 2 / Vue 3 模板选择与用户目标技术栈一致。
- 本技能聚焦项目创建与初始化；组件与 API 参考请参见 uniapp-project-guide。
最佳实践
- 选择合适模板：根据项目需求选择 Vue 2 或 Vue 3。
- 正确配置：正确设置 manifest.json 与 pages.json。
- 组织结构：遵循标准 uni-app 目录结构。
- 尽量使用 CLI：CLI 比 HBuilderX 提供更高灵活性。
- 版本控制：项目创建后初始化 git 仓库。
资源
- 官方文档：https://uniapp.dcloud.net.cn/quickstart-cli.html
- HBuilderX：https://www.dcloud.io/hbuilderx.html
- Vue CLI：https://cli.vuejs.org/
- uni-app GitHub：https://github.com/dcloudio/uni-app
关键词
uniapp, uni-app, project creator, project initialization, HBuilderX, Vue CLI, manifest.json, pages.json, uni-app setup, uni-app template, 创建项目, 项目初始化, 快速开始