如何使用vsCode搭建运行uni-app项目

3,744 阅读2分钟

我们都知道,如果想做一个uniapp项目,Dcloud提供了一个强大的编译器HBuilder X,它提供的可视化的方式比较简单,开箱即用,无需配置nodejs。 但是,HBuilder X对于强类型的支持和监测是没有vsCode那么完善的,我们习惯了用vsCode开发前端项目,今天就试试用vsCode搭建一个uniapp微信小程序项目。

第一步,项目创建

由于只有在HBuilder X中才可以可视化的新建uni-app项目,在其他编译器中必须使用cli脚手架来搭建项目,vsCode也不例外,以下是官网介绍的cli创建项目的几个命令 uniapp.dcloud.net.cn/quickstart-…

image.png

我们选择使用Vue3/Vite+ts版

执行
npx degit dcloudio/uni-preset-vue#vite-ts uni-app-vue3-ts

image.png

可以看到项目已经创建出来,我们使用vsCode把项目打开:

image.png

这样项目就创建成功了!

第二步,安装依赖

现在还是一个vue项目,如何把它编译成uni-app项目呢?就需要我们安装依赖,打开终端

执行 npm i

安装成功后,项目中就会出现我们熟悉的node_modules依赖包

image.png

第三步,安装插件

HBuilder X之所以方便创建开发uni-app项目,是由于他内部对uni-app特有的兼容性,而如果想在vsCode中也方便开发,vsCode提供了几个插件需要安装

1、uni-create-view

image.png

这个插件主要是帮助我们快速创建uniapp视图和组件,我们安装好后,在项目中右键就会发现:

image.png

新建uniapp页面相关操作

2、uni-helper

image.png

这个插件主要是增加代码提示功能

3、uniapp小程序扩展

image.png

这个插件提供给我们鼠标悬停查看文档功能

image.png

第四步,ts类型校验

npm i -D @types/wechat-miniprogram @uni-helper/uni-app-types

这里面一共两个,一个针对微信小程序类型声明文件,一个uniapp声明文件,执行上面代码后,我们在package.json中就可以看到这两个包:

image.png

然后我们在tsconfig.json中进行配置:

image.png

image.png

看,这样就会把错误的类型报出来!

第五步,解决json文件中的注释问题

回过头来,我们看到项目中会出现两处报错的文件,一个是manifest.json,另一个是pages.json

image.png

image.png

原因都一样,就是vsCode对json文件采取的是严格json模式,不允许有注释,所以才会报错,解决办法也很简单,我们在设置中,找到文件关联,把这两个文件改成jsonc就可以了:

image.png

第六步:项目运行调试

image.png

执行 pnpm dev:mp-weixin

image.png

项目中会出现dist文件夹,我们用微信开发者工具,打开目录 dist/dev/mp-weixin

image.png

同样在vsCode中改变某个文件,开发者工具也会同步热更新,至此,vsCode搭建一个uni-app项目就完成啦!