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