uni-app 中无法直接 import Vant Weapp，因其依赖微信原生 Component 和 behavior，仅支持在小程序端（如 mp-weixin）通过 pages.json 的 usingComponents 手动引入组件路径，并需配置 transpileDependencies 与关闭自定义组件兼容模式。
uni-app 里直接 import Vant Weapp 会报错
因为 vant weapp 是为微信原生小程序写的，它依赖 component 构造器的原生写法和 behavior 机制，而 uni-app 的编译器（尤其是 h5 和 app 端）不识别这些。你如果在 .vue 文件里写 import vanbutton from 'vant-weapp/button/index'，打包时大概率遇到 cannot find module 'vant-weapp' 或运行时报 component is not defined。
真正能走通的路径只有一条：用 Vant Weapp 的「小程序组件」方式，在支持它的平台（仅微信/支付宝/百度等小程序端）中通过 customComponent 引入，且必须关闭 uni-app 的「自定义组件模式」兼容处理。
- 只在
mp-weixin（微信小程序）构建时生效，H5、App、快应用等完全不支持 - 需在
pages.json中为对应页面开启"usingComponents": true - 需在
vue.config.js中配置configureWebpack.chainWebpack，把node_modules/vant-weapp加入 transpileDependencies（否则 ES6+ 语法无法被小程序基础库识别）
如何在 pages.json 里正确声明 vant-weapp 组件
uni-app 要让小程序原生组件可用，必须在页面级 JSON 配置中显式声明路径，不能靠自动扫描。Vant Weapp 的组件路径是固定结构，比如 button 对应 node_modules/vant-weapp/button/index，但 uni-app 编译后路径会变，所以得用相对路径 alias 或复制进项目。
推荐做法是：把需要的组件手动拷贝进 uni_modules/vant-weapp 目录（模拟 uni_modules 结构），再在 pages.json 里写死路径：
"usingComponents": {
"van-button": "/uni_modules/vant-weapp/button/index"
}
- 路径必须以
/开头，且是相对于项目根目录的绝对路径 - 不能写成
node_modules/vant-weapp/...—— 小程序基础库读不到node_modules - 每个用到 Vant 组件的页面都要单独配
usingComponents，不能全局注册 - 支付宝小程序要用
van-button，但实际要配成van-button（名称一致），不过其内部index.axml必须存在，否则编译失败
template 中使用 vant-weapp 的写法和坑点
模板里可以直接写 <van-button type="primary">按钮</van-button>，但要注意三件事：属性名、事件绑定、插槽。
- 属性名必须小写连字符（
bind:click），不能用@click—— uni-app 的@语法会被转成bindtap，而 Vant 组件只响应bind:click - 事件回调函数必须写在
methods里，且参数是event.detail，不是event；例如：onClick(e) { console.log(e.detail); } - 插槽内容（如
van-button里的文字）可以写，但slot名必须匹配组件定义，Vant Weapp 多数用default，不是#default—— 不要加# - 样式隔离：Vant Weapp 自带 wxss，但 uni-app 的 scoped style 不影响它，所以若想覆盖
van-button样式，得在页面级<style></style>里写非 scoped 规则，或用!important
为什么不要尝试用 npm install vant + vue 版本
有人试过 npm install vant 然后在 <script></script> 里 import { Button } from 'vant'，这在 H5 没问题，但在小程序端会彻底失效 —— 因为 uni-app 小程序端不执行 import 语句，也不支持 Vue 的 component 全局注册逻辑，所有组件必须由小程序原生 Component 构造器创建。
- Vant 的 Vue 版本（
vant）和小程序版本（vant-weapp）代码完全不同，API 表面相似，底层不可互换 - uni-app 官方插件市场里搜到的 “Vant UI” 插件，基本都是社区魔改版，维护停滞、不兼容新版本、缺失部分组件
- 如果你真需要跨多端 UI 库，不如用
@vant/weapp+ 条件编译，或直接切到uni-ui—— 它是 uni-app 官方维护、全端可用的替代方案
最麻烦的其实是调试：微信开发者工具里看到的组件树是原生节点，Vue Devtools 看不到内部响应式数据，出了问题只能靠 console.log 打 event.detail 和 setData 调用链。这点容易被忽略，但实际占掉一半排错时间。
