在微信小程序中安装和使用vant框架

最新推荐文章于 2025-07-29 19:12:28 发布

gblfy

最新推荐文章于 2025-07-29 19:12:28 发布

阅读量2.6k

点赞数 4

CC 4.0 BY-SA版权

分类专栏：原生微信小程序文章标签：微信小程序小程序

本文链接：https://blog.csdn.net/weixin_40816738/article/details/144096263

原生微信小程序专栏收录该内容

2 篇文章

订阅专栏

文章目录

本文将详细介绍如何在微信小程序中安装并使用vant框架～

开发工具：微信开发者工具

1、初始化项目

从终端进入小程序项目目录，执行初始化命令：

npm init

在这里插入图片描述
初始化之后，会看到项目根目录下多了一个package.json文件：

2、安装vant相关依赖

执行命令以下

npm i @vant/weapp -S --production
npm i miniprogram-sm-crypto --production

执行成功后，会看到项目多了一个node_modules文件夹：
在这里插入图片描述

3、修改 app.json

移除： “style”: “v2”
原因：小程序强行加上了许多样式，难以覆盖，不关闭将造成部分组件样式混乱。

4、修改 project.config.json

在微信开发者工具创建的项目，miniprogramRoot 默认为 miniprogram，package.json 在其外部，npm 构建无法正常工作。

所以需要手动在 project.config.json 内添加如下配置，使开发者工具可以正确索引到 npm 依赖的位置。

"setting": {
    "packNpmManually": true,
    "packNpmRelationList": [
      {
        "packageJsonPath": "./package.json",
        "miniprogramNpmDistDir": "./"
      }
    ]
 }

5、构建npm

左上角工具 > 构建npm > 构建成功，然后就可以使用组件啦～
在这里插入图片描述

6、使用示例

本文将详细介绍如何在微信
2种方式：全局引入和局部引入，其实就是在入口的app.json 或各子页面.json 配置usingComponents

1）全局使用示例：button

在app.json中引入：

"usingComponents": {
    "van-button": "@vant/weapp/button/index"
 }

在任意页面可以使用button组件：

van-button type="primary">按钮</van-button>

在这里插入图片描述
2）局部使用示例：slider
在index页面使用，引入组件：

{
	"usingComponents": {
		"van-slider": "@vant/weapp/slider/index"
	}
}

在这里插入图片描述
使用：index.wxml

<van-slider value="50" bind:change="onChange" />

在这里插入图片描述