无需 HBuildX!用 VSCode 开启 Uniapp 小程序的微信开发之旅

5,383 阅读3分钟

前言:

Uniapp作为一个跨平台的开发框架,为开发者提供了诸多便利。在小程序开发的领域,工具的选择往往影响着开发的效率和体验。而HBuilderXUniapp官网推荐的前端开发工具,由于我平时用的是VSCode,也有微信开发者工具,不想重新下载工具。

本文主要介绍如何利用VSCode编辑器打开Uniapp小程序,并在微信开发者工具中成功启动且实时更新。

一、背景

上周被分配一个小程序的任务,这个小程序是同事用Uniapp写的,我是第一次接触这个项目,且第一次接触Uniapp写的小程序。

gitclone下来项目后,经过了解,网上大多数都是用HBuilderX结合微信开发者工具启动项目,而我之前用Taro写小程序的时候,就是VSCode结合微信开发者工具使用,且能实时更新,再者也不想重新下载其他工具,于是研究了下,后来成功实现!

备注:

过程中也遇到了运行的问题,一并分享出来,即总共要解决的问题有:

  1. 如何利用VSCode打开Uniapp小程序,并在微信开发者工具中成功启动且实时更新?
  2. clone下来的项目,在进行npm install时报错,如何解决?

二、成功启动项目的方法

  1. 首先在VSCode中打开此项目;
  2. 然后运行npm install命令,根据Uniapp官网的介绍,这一点很好理解:

image.png

  1. 把相关依赖下载完后,执行npm run serve

image.png

  1. 运行成功后,在微信开发者工具里打开上图中dist/dev/mp-weixin目录下的文件:

image.png

可以看到这个目录下的文件结构就跟原生小程序目录结构相同了,在微信开发者工具中可以正常使用。

如果在VSCode中写代码,微信开发者工具中也会同步更新:

image.png

三、npm install时报错的解决方案

估计很多人都会出现类似的报错信息:

image.png

request to https://registry.npm.taobao.org/set-immediate-shim/download/set-immediate-shim-1.0.1.tgz failed, reason: certificate has expired

翻译出来的话,是从淘宝的npm镜像(https://registry.npm.taobao.org)下载 set-immediate-shim 包时失败了。证书过期

从网上也找到了很多下面这种原因和解决方案:

image.png

image.png

但是!都不行!依旧没有解决我这边的问题,而且cnpm install也不行,在其他项目中就可以。

于是我就用了yarn install

image.png

image.png

大功告成!

注:这里要记得执行yarn install前,要先删包,即把node_modules包删掉。防止有其他问题或者install失败。

四、总结

本文详细介绍了利用VSCode打开 Uniapp 写的小程序,并在微信开发者工具中启动。从在 VSCode 中的项目导入与配置,到与微信开发者工具的衔接,每一个步骤都进行了清晰的讲解。对于我这种没用过HBuilderX、习惯用VSCode的人来说,这种方式为我的 Uniapp 小程序开发带来了更多的便利和灵活性。

以上,希望对大家有帮助!