前言
uni-app 是一个基于 Vue.js 开发所有前端应用的框架,开发者编写一套代码,可发布到iOS、Android、Web(响应式)、以及各种小程序(微信/支付宝/百度/头条/QQ/钉钉/淘宝)、快应用等多个平台。
在开发过程中可能会遇到一些异常,这些异常及其解决办法总结如下。
1.调用微信开发者工具报错IDE service port disabled
在HBuilderX下开发好项目后,要使用小程序模拟器进行运行调试时,控制台报错如下:
21:48:18.851 [微信小程序开发者工具] [error] IDE service port disabled. To use CLI Call, please enter y to confirm enabling CLI capability, or manually open IDE -> Settings -> Security Settings, and set Service Port On. 21:48:18.859 [微信小程序开发者工具] For more details see: https://developers.weixin.qq.com/miniprogram/en/dev/devtools/cli.html 21:48:18.859 [微信小程序开发者工具] [error] 工具的服务端口已关闭。要使用命令行调用工具,请在下方输入 y 以确认开启,或手动打开工具 -> 设置 -> 安全设置,将服务端口开启。 21:48:18.866 [微信小程序开发者工具] 详细信息: https://developers.weixin.qq.com/miniprogram/dev/devtools/cli.html
此时是因为微信开发者工具未打开服务端口,根据提示,打开微信开发者工具 -> 设置 -> 安全设置 -> 开启服务端口
即可,如下:
2.@import导入外部样式失效
有时候在进行uni-app开发时,需要在App.vue或者某个页面的style块中导入外部已写好的样式,但是导入后可能会发现样式无效,如下:
<style> /*每个页面公共css */ .red { color: #ff0000; } /* 引入自定义图标库 */ @import './static/font/iconfont.css'; </style>
这是因为通过@import
导入外部样式需要将其放于style块的最前面,而不能放到中间或后面位置,这样会失效,同时应该在导入语句后加上分号;
,这样才会生效。
3.v-for列表渲染指定:key
属性报错Duplicate keys detected
uni-app提倡在进行列表渲染,即v-for
循环遍历列表时添加:key
属性来指定列表中项目的唯一的标识符,以确保使组件保持自身的状态、并提高列表渲染效率。
但是有时候会出现警告,例如:
<template> <view> <!-- 话题信息 --> <topic-info :info="info"></topic-info> <divider></divider> <!-- 精华帖 --> <block v-for="(item, index) in hotList" :key="index"> <view class="p-2 flex align-center border-bottom" hover-class="bg-light"> <text class="iconfont icon-zhiding text-main"></text> <text class="font text-dark text-ellipsis">{{item.title}}</text> </view> </block> <divider></divider> <!-- 标签栏 --> <view class="flex align-center py-2"> <view class="flex-1 font-lg font-weight-bold text-main flex align-center justify-center">默认</view> <view class="flex-1 font-md flex align-center justify-center">最新</view> </view> <!-- 列表 --> <block v-for="(item, index) in list1" :key="index"> <common-list :item="item" :index="index"></common-list> </block> </view> </template>
警告信息如下:
16:42:29.421 [Vue warn]: Duplicate keys detected: '0_0'. This may cause an update error. 16:42:29.463 (found at pages/topic-detail/topic-detail.vue:1) 16:42:29.484 [Vue warn]: Duplicate keys detected: '1_0'. This may cause an update error. 16:42:29.524 (found at pages/topic-detail/topic-detail.vue:1)
这是因为一个template中有两个或多个v-for
,它们的:key
值都为index
、出现冲突,此时只需给不同循环的:key
值拼接不同的前缀或者后缀即可。
修改如下即可:
<template> <view> <!-- 话题信息 --> <topic-info :info="info"></topic-info> <divider></divider> <!-- 精华帖 --> <block v-for="(item, index) in hotList" :key="'hot'+index"> <view class="p-2 flex align-center border-bottom" hover-class="bg-light"> <text class="iconfont icon-zhiding text-main"></text> <text class="font text-dark text-ellipsis">{{item.title}}</text> </view> </block> <divider></divider> <!-- 标签栏 --> <view class="flex align-center py-2"> <view class="flex-1 font-lg font-weight-bold text-main flex align-center justify-center">默认</view> <view class="flex-1 font-md flex align-center justify-center">最新</view> </view> <!-- 列表 --> <block v-for="(item, index) in list1" :key="index"> <common-list :item="item" :index="index"></common-list> </block> </view> </template>
此时便不会出现警告信息。