正确安装uView需将uview-ui文件夹放入uni_modules目录并重启HBuilderX；Vue2用Vue.use(uView)，Vue3用app.use(uView, config)且config必须含$u字段；不支持按需导入，须通过easycom或全量引入。
uni-app
项目里怎么正确安装 uView
直接用
装完就以为能用了？大概率会报错，因为 uView 不是纯 npm 包，它依赖一套特殊的引入机制。官方推荐方式是通过
或下载 ZIP 解压到
目录下——这是 uni-app 插件生态的硬性约定，不是可选项。
必须把 uView 文件夹完整放进项目根目录下的
（不是
）
文件夹名必须是
，不能改，否则 HBuilderX 启动时识别不了
装完别急着写组件，先重启 HBuilderX 或运行
等命令触发重新扫描
如果用 CLI 创建项目（没开 HBuilderX），得手动在
或
里加
，否则小程序端会白屏
main.js 里怎么注册 uView 才不报错
注册顺序错了，
的
方法就找不到
实例，尤其在 Vue 3 + Composition API 的 uni-app 项目里，容易误用
的链式调用方式。
Vue 2 项目：在
里
后，必须紧接
，且要在
之前
Vue 3 项目（uni-app 3.0+）：不能用
，得用
，且
必须是从
或
返回的实例
千万别在
的
里注册，那已经太晚了，组件渲染时插件还没挂载
如果用了 TypeScript，记得在
里加
，否则类型提示全丢
全局配置 uView 主题和默认参数在哪改
uView 的主题色、图标大小、表单校验规则这些，不是靠修改 CSS 变量就能生效的，得走它的
配置对象，而且必须在
或
中注册前传入。
uni-app电商系统实战精讲课程课件
uni-app电商系统实战精讲课程
下载
配置对象要作为第二个参数传给
，例如：
关键字段是
，不是
或
，写错名字整个配置就静默失效
部分配置（比如
的默认
）只对未显式设置属性的组件生效，写了
就不会读配置
微信小程序真机调试时，某些颜色变量（如
）可能不生效，这是小程序 canvas 渲染限制，得换纯色方案
为什么 uView 组件在 H5 正常，小程序里不显示
最常见原因是路径引用错误或平台条件编译漏掉。uView 内部做了大量平台判断，但你写的组件调用如果没遵循 uni-app 的跨平台规范，就会断在某一层。
别用
按需导入——uView 不支持这种写法，所有组件都得通过
或自动按需（需开启
）
检查
里有没有误删
块，H5 和小程序共用同一份 JSON，但小程序端必须有该字段才能识别自定义组件
如果用了
切换 uView 组件，确保条件值不是
或
，小程序对响应式依赖追踪比 H5 更敏感
真机调试时打开 vConsole，搜
开头的组件标签是否被渲染成
，如果是，说明组件没正确注册，回到第一步查
目录结构
uView 的配置链条很长，从文件落地、注册时机、配置传参到平台适配，每一步都有明确的“非此不可”约束。漏掉任意一环，它都不会报红错，而是静默失效——这点最容易让人卡半天还找不到原因。
npm install uview-uigit cloneuni_modulesuni_modulesnode_modulesuview-uinpm run dev:mp-weixinvue.config.jsvue.config.tstranspileDependencies: ['uview-ui']uViewinstallVuecreateAppmain.jsimport uView from 'uview-ui'Vue.use(uView)new Vue(...)Vue.useapp.use(uView)appcreateSSRAppcreateAppApp.vueonLaunchshims-vue.d.tsdeclare module 'uview-ui'configmain.jsmain.tsapp.use(uView, config)app.use(uView, { $u: { color: { primary: '#1890ff' } } })$uthemeglobalbuttonsizesize="small"gradientimport { uButton } from 'uview-ui'import 'uview-ui/lib/weapp'easycompages.json"usingComponents"v-ifnullundefinedu-*viewuni_modules