uniapp项目安装运行操作手册

一，安装运行环境

1.下载node.js

node.js下载链接node.js

请下载长期支持版。

2.安装node.js

安装教程百度可查这里就不详细说明了，安装教程地址链接

3.验证node是否安装成功

打开cmd 执行 npm -v 和node -v 看是否出现当前安装的版本号

二，运行项目准备

1.安装项目依赖

打开你项目的根目录执行npm install 下载项目对应的依赖包

下面这种就是在下载项目所要用到的依赖包，

这是依赖下载成功的图片

2.运行项目（h5）

同样在你的项目根目录下执行npm run serve 命令

下图就是运行成功的图片结果，直接在你的浏览器中打开访问下面的地址即可。（通常访问地址都是htttp://localhost:+端口号）

而下图有指向h5目录是因为修改了项目里面的h5指向路径，具体如何修改请仔细阅读uniapp官方文档

链接

3.运行项目（微信小程序）

1.请先下载hbuildx开发工具

下载地址链接

2.运行项目到微信小程序

将项目导入到hbuildx开发工具中，点击运行，选择运行到小程序模拟器。

注意（要先保证，本地有下载微信开发者工具，下载地址链接，请下载稳定版）

微信开发者工具需要要登录

3.运行成功（微信小程序）

hbuildx编译成功会自动打开微信开发者工具，运行项目。

三，常见问题

1.下载依赖报错 (node-sass报错)

1.解决方法

删除原来下载的node-sass包

npm uninstall node-sass

重新执行下载安装命令

npm install node-sass

2.重新下载还是不行，就查看一下自己安装的node版本，是不是版本太低导致

重新安装node.js 下载安装链接都在文章里，请仔细阅读。

2.安装依赖缺失

类似下面的报错通常都是依赖文件没有安装全导致

Cannot find module '@dcloudio/uni-migration'。

请执行 npm install @dcloudio/uni-migration -s (注意这里只是举例说明，缺失哪个包就安装哪个)

3.编译微信小程序运行到开发者工具报错

1.请检查微信开发者工具服务端口是否开启

2.检查该开发者工具登录账号是否有对应小程序的开发者权限

3.编译过程中提示Browserslist: caniuse-lite is outdated. Please run next command npm update

这个可忽略，建议不执行（当然uniapp官方版本更新稳定，执行下载没问题）

4.打包成app报错

将这块内容注释，就不会打包失败。

（随着uniapp版本更新这个问题也不会出现）

---

结束语

此文档仅用来解决一下常见问题，更多问题请查阅uniapp官方文档链接