微信小程序构建 npm 的坑

微信小程序构建 npm 的坑

前言

开发微信小程序时想使用 Vant Weapp,跟着文档构建 npm 一直失败,记录一下成功构建的步骤。

环境

系统:MacOS 14.2.1 (23C71)

微信开发者工具:Nightly 1.06.2401232

Node:v20.9.0

npm:10.1.0

模板:官方 TS + Sass - 基础模板

初始化环境

使用官方模板初始化环境:

由于笔者使用的是 TS ,因此初始化完成后可以看到已经存在package.json文件,其中安装了微信 api 的 TS 类型声明文件包:

(初始化的 name 居然是 miniprogram-ts-less-quickstart ,笔者明明选的是 sass ,真是粗心啊)

安装 Vant

根据 Vant Weapp 的文档安装:

sql 复制代码
 yarn add @vant/weapp --production

已经成功安装,出现了node_modules文件夹。

构建 npm

根据 Vant Weapp 的文档中的步骤三修改 project.config.json:

笔者的微信开发者工具应该算是新版,因此根据文档:

注意: 由于目前新版开发者工具创建的小程序目录文件结构问题,npm构建的文件目录为miniprogram_npm,并且开发工具会默认在当前目录下创建miniprogram_npm的文件名,所以新版本的miniprogramNpmDistDir配置为'./'即可

构建 npm :

然后提示错误:

这时候笔者摸不着头脑了已经,经过一番冲浪,看到了这个文章,原来是要重新打开项目...

重新打开项目(退出编辑器重新打开也可以),构建 npm 成功:

出现了miniprogram_npm目录。

测试

笔者在 index 页面中放置一个 van-button 测试一下:

分析报错信息,是因为开发者工具找组件的位置不对:

bash 复制代码
 /Users/allen/code/demos/weapp-demo/miniprogram/pages/index/@vant/weapp/button/index 
 /Users/allen/code/demos/weapp-demo/miniprogram/pages/index/@vant/weapp/button/index/index 
 /Users/allen/code/demos/weapp-demo/miniprogram/pages/index/miniprogram_npm/@vant/weapp/button/index
 /Users/allen/code/demos/weapp-demo/miniprogram/pages/index/miniprogram_npm/@vant/weapp/button/index/index
 /Users/allen/code/demos/weapp-demo/miniprogram/pages/miniprogram_npm/@vant/weapp/button/index
 /Users/allen/code/demos/weapp-demo/miniprogram/pages/miniprogram_npm/@vant/weapp/button/index/index
 /Users/allen/code/demos/weapp-demo/miniprogram/miniprogram_npm/@vant/weapp/button/index
 /Users/allen/code/demos/weapp-demo/miniprogram/miniprogram_npm/@vant/weapp/button/index/index

而包安装位置是:

css 复制代码
 /Users/allen/code/demos/weapp-demo/miniprogram_npm/@vant

因此还是路径配置的问题,npm 构建的输出目录,并不在开发者工具的查找范围内。

找到project.config.json,进行修改:

json 复制代码
 {
   ...,
   "settings": {
     ...,
     "packNpmRelationList": [
       {
         "packageJsonPath": "./package.json",
         "miniprogramNpmDistDir": "./miniprogram"
       }
     ]
   },
   ...
 }

然后重新构建 npm:

可以看到,在miniprogram目录下新生成了miniprogram_npm目录,删除根目录下多余的miniprogram_npm目录。

可以看到van-button组件已经成功出现了。

总结

  1. 修改project.config.json后,如果构建 npm 失败,重新打开项目再试。
  2. Vant Weapp 文档快速上手步骤三中有一个注意,目前版本的开发者工具不需要根据注意进行修改。

如果不当之处,欢迎批评斧正。

相关推荐
kyriewen15 小时前
编辑弹窗点了取消,列表里的数据怎么还是变了?
前端·javascript·人工智能
Karl_fang16 小时前
🥳 再也不用拿起手机抄验证码!我做了一个 Android → Mac 的「验证码接力」工具
前端·macos·ai编程
谭光志17 小时前
如何让 AI 高效工作
前端·后端·ai编程
FRing0318 小时前
vue2干货总结11(短信验证、登录功能、统一处理错误(响应拦截器)、将token信息存入vuex、vuex持久化处理)
开发语言·前端·javascript·vue.js·vue2
泯泷18 小时前
改一个字,整段都红了?——中文内容差异对比的算法与协议设计
前端·javascript·typescript
再吃一根胡萝卜18 小时前
DSH plugin 开发示例:五种插件形态完整代码整理
前端
Yk酱2284018 小时前
A2UI随笔-demo-01
前端
云起SAAS18 小时前
本地生活同城多商户商城系统源码源码 合伙人分红加区域代理加排队返现
前端·javascript·后端
奶油话梅糖18 小时前
3 天 1,705 Star:DeepSeek 开源官方聊天前端——零后端纯静态,浏览器直连 API
前端·开源
Linye19 小时前
HTML 流程图连线交叉看不清?聊聊画布避障折线与跳弧实现
前端·人工智能