Uniapp 运行打包教程(基础 )

UniApp 打包前置准备指南

本教程适用于 新发布的 Vue3 版本 UniApp 项目。旧版本不兼容,请勿参考。 本教程仅为打包准备,打包后的资源需使用对应平台工具(如微信开发者工具)运行或发布。


环境准备

请提前安装以下工具:

  1. Node.js 推荐版本:>=18 下载地址:Node.js 官网
  2. 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_modulespnpm-lock.yaml,再重新安装依赖:
    pnpm install