huahuibao_document/front_end/hdApp -- uni-app 升级.md

---

type: frontend project: 花掌柜 app:

• hdApp status: doing module: 前端文档 tags:
• frontend
• 前端文档 created: 2026-06-09 updated: 2026-06-09 sensitive: false ---

官方升级文档 https://uniapp.dcloud.net.cn/quickstart-cli.html#cliversion

参考的博文 https://tw.icebreaker.top/docs/upgrade/uni-app

升级版本的 git 提交：11592883df git 查看相关依赖包变动

git show 11592883dfafa696fe0a3d76dadebbf353315d48

安装 nvm

安装说明请查看 [[nvm笔记]]

node.js 版本要求 18 以上

请安装 18 或者 20

安装最新版本的 18 `nvm install v18.20.8

安装最新版本的 20 nvm install v20.19.4

项目安装命令

正常情况

npm install

若报错

• 方案一 安装过程中遇到了 puppeteer 下载 Chromium 的网络问题。让我们跳过 puppeteer 的下载，然后重新安装

  PUPPETEER_SKIP_DOWNLOAD=true npm install
  

• 方案二

  export PUPPETEER_DOWNLOAD_BASE_URL=https://cdn.npmmirror.com/binaries/chrome-for-testing
  

  npm install

  测试

  执行编译小程序

  npm run dev:mp-weixin
  

  有如下输出，则说明安装成功：

  % npm run dev:mp-weixin
  
  > hd@0.1.0 dev:mp-weixin
  > cross-env NODE_ENV=development UNI_PLATFORM=mp-weixin vue-cli-service uni-build --watch
  
  请注意运行模式下，因日志输出、sourcemap以及未压缩源码等原因，性能和包体积，均不及发行模式。若要正式发布，请点击发行菜单或使用cli发布命令进行发布
  小程序各家浏览器内核及自定义组件实现机制存在差异，可能存在样式布局兼容问题，参考：https://uniapp.dcloud.io/matter?id=mp
  
  ⠦  开始编译当前项目至 mp-weixin 平台...
  
  ......
  
  DONE  Compiled successfully in 33799ms                                          DONE  Build complete. The dist/dev/mp-weixin directory is ready. Watching for changes...
  运行方式：打开 微信开发者工具, 导入 dist/dev/mp-weixin 运行。