Uniapp 运行打包教程(基础 )
UniApp 打包前置准备指南
本教程适用于 新发布的 Vue3 版本 UniApp 项目。旧版本不兼容,请勿参考。 本教程仅为打包准备,打包后的资源需使用对应平台工具(如微信开发者工具)运行或发布。
环境准备
请提前安装以下工具:
- Node.js
推荐版本:
>=18下载地址:Node.js 官网 - pnpm
推荐版本:
>=7.30全局安装命令:npm install -g pnpm
安装依赖
在项目根目录下执行以下命令:
pnpm install
如遇安装失败,请确认:
- 已正确安装 Node.js 和 pnpm
- 使用的是推荐版本
如何运行或发布?
根据目标平台使用对应方式运行或打包,例如:
- H5 平台:使用浏览器或服务器直接运行打包资源
- 微信小程序:使用微信开发者工具导入打包目录并预览/发布
请参考对应平台的官方文档获取详细步骤。
项目目录结构说明
| 目录 | 说明 |
|---|---|
src/ |
主源码目录 |
src/pages/ |
页面文件 |
src/components/ |
通用组件 |
src/api/ |
API 接口封装 |
src/store/ |
状态管理(如 Pinia 等) |
src/utils/ |
工具函数 |
src/static/ |
静态资源(图片、样式等) |
常见问题
- 依赖安装失败? 请确认已全局安装 pnpm,并使用推荐的 Node.js 版本。
- 运行报错?
可尝试删除
node_modules和pnpm-lock.yaml,再重新安装依赖:pnpm install