必须配置pages.json中的easycom规则,否则uni-app无法自动解析等标签;仅npm install后组件虽存于uni_modules,但未配置则需手动import注册,导致开发效率骤降。

直接用 easycom 全局注册 + @dcloudio/uni-ui 安装即可开写,不用每个页面手动 import,否则原型搭建速度会掉一半。
为什么不能只靠 npm install 就完事?
安装 @dcloudio/uni-ui 后,组件文件确实进了 uni_modules 目录,但 uni-app 默认不会自动识别并加载它们。不配置 easycom,你得在每个 .vue 文件里重复写 import 和 components 注册,原型阶段改个按钮都要动三处代码,效率极低。
-
pages.json必须加easycom配置,否则组件标签不解析(比如写<uni-button></uni-button>会直接白屏或报错) - 路径必须严格匹配:官方文档给的正则
"^uni-(.*)": "@dcloudio/uni-ui/lib/uni-$1/uni-$1.vue"不能少斜杠、不能漏lib - HBuilderX 3.9+ 支持自动扫描,但 VSCode + uni-app 插件需重启服务才能生效
pages.json 的 easycom 配置怎么写才不踩坑?
这是最常出错的一环。错误配置会导致组件找不到、样式丢失、甚至 H5 端正常但小程序端报 Component is not found。
- 必须放在
pages.json根对象下,不是tabBar或subNVue里 - 正则中的
$1是占位符,对应你模板中写的组件名,例如<uni-button></uni-button>→ 匹配到button→ 自动拼成完整路径 - 如果用了自定义前缀(如
<my-button></my-button>),正则要同步改成"^my-(.*)": "path/to/my-$1.vue" - 多组件库共存时,顺序很重要:先配
uni-,再配u-,避免正则冲突
uni-ui 组件在原型阶段怎么用才快?
原型不是生产环境,别纠结主题定制或深度封装。目标是「改一行属性就看到效果」。
- 优先用带默认样式的组件:比如
<uni-card></uni-card>比手写<view class="card"></view>少 10 行 CSS - 交互逻辑先 mock:点击事件里直接写
uni.showToast({ title: '跳转中' }),别急着连 API - 图片占位用
https://via.placeholder.com/300x200,避免本地路径编译失败 - 轮播图、列表等组件直接传静态数组,不用写
onLoad+uni.request套路
真正卡住原型进度的,往往不是组件功能,而是 easycom 路径拼错、pages.json 缩进格式非法、或者 HBuilderX 缓存没清导致配置不热更新——这些细节比学 API 更影响当天能不能跑通首页。











