zcm
zcm
  • 发布:2026-01-05 12:59
  • 更新:2026-01-05 13:40
  • 阅读:61

hbuilderX上新建uni-app x项目,一切默认,启动失败

分类:uni-app x

hbuilderX上新建uni-app x项目,一切默认,然后通过菜单:运行-》运行到浏览器-》chrome,然后启动时,控制台报错如下:
[广告] 12:53:29.644 uni-cdn,比主流云厂商便宜30%,更具性价比!详情
12:53:29.661 项目 testx 开始编译
12:53:30.500 请注意运行模式下,因日志输出、sourcemap 以及未压缩源码等原因,性能和包体积,均不及发行模式。
12:53:30.500 vite是按需编译,运行时点击某个未编译页面会先编译后加载,导致显示较慢,发行后无此问题。
12:53:30.500 编译器版本:4.24(uni-app x)
12:53:30.500 正在编译中...
12:53:31.378 error when starting dev server:
12:53:31.378 TypeError: Cannot convert undefined or null to object
12:53:31.378 at Function.keys (<anonymous>)
12:53:31.378 at normalizeStyles (D:\soft\HBuilderX\plugins\uniapp-cli-vite\node_modules\@dcloudio\uni-shared\dist\uni-shared.cjs.js:1586:12)
12:53:31.379 at D:\soft\HBuilderX\plugins\uniapp-cli-vite\node_modules\@dcloudio\uni-shared\dist\uni-shared.cjs.js:1594:32
12:53:31.379 at Array.map (<anonymous>)
12:53:31.379 at parseStyleItem (D:\soft\HBuilderX\plugins\uniapp-cli-vite\node_modules\@dcloudio\uni-shared\dist\uni-shared.cjs.js:1592:34)
12:53:31.379 at D:\soft\HBuilderX\plugins\uniapp-cli-vite\node_modules\@dcloudio\uni-shared\dist\uni-shared.cjs.js:1599:23
12:53:31.379 at Array.forEach (<anonymous>)
12:53:31.379 at normalizeStyles (D:\soft\HBuilderX\plugins\uniapp-cli-vite\node_modules\@dcloudio\uni-shared\dist\uni-shared.cjs.js:1586:28)
12:53:31.379 at D:\soft\HBuilderX\plugins\uniapp-cli-vite\node_modules\@dcloudio\uni-shared\dist\uni-shared.cjs.js:1594:32
12:53:31.379 at Array.map (<anonymous>)
12:53:31.396 已停止运行...

这是什么原因呢?本机环境windows10,hubilderX版本4.24

2026-01-05 12:59 负责人:无 分享
已邀请:
Ask小助手

Ask小助手

该问题请在专业群( uni-app x技术交流群 ) 咨询,群中有相关专业的管理员和群友。

根据您描述的问题和错误日志,这是HBuilderX 4.24版本的已知问题。错误TypeError: Cannot convert undefined or null to object出现在normalizeStyles函数中,属于uni-app x编译器在处理样式时的bug。

原因分析:

  • 您使用的HBuilderX 4.24版本较旧(当前最新正式版为4.87)
  • 该问题已在ISSUE系统记录(#15795),具体表现为样式处理逻辑存在缺陷
  • 官方在后续版本中已修复此问题,评论中明确提到"可以升级到4.45,就可以运行了"

解决方案:

  1. 升级HBuilderX至最新正式版(4.87)
  2. 升级后重新创建项目测试
  3. 若仍需临时解决,可参考ISSUE中的方案修改源码(但强烈建议升级)

注意事项:

  • uni-app x的Web平台编译对HBuilderX版本敏感,旧版本可能存在兼容性问题
  • 运行模式下vite是按需编译,首次加载稍慢属正常现象,但不应出现编译错误
  • 升级前请备份项目,可通过HBuilderX菜单"帮助->检查更新"获取最新版

建议立即升级HBuilderX,这是最安全有效的解决方案。如遇其他问题可查阅uni-app x Web开发文档

内容为 AI 生成,仅供参考
套马杆的套子

套马杆的套子 - 没有解决不了的问题,只有解决不完的问题

我刚新创建了一个,版本是4.87,你看下截图,没发现问题,你先升下hbx版本吧,感觉版本有点低呢

zcm

zcm (作者) - It's my time.

我如果升级了hbuilderx的话,我以前的旧项目用这个新升级的hbuilderx运行会不会存在风险啊,到时候打不开会运行报错等?

  • 套马杆的套子

    正常是不会的,如果有问题,你还可以在官网上下载过去老的版本

    2026-01-05 14:07

要回复问题请先登录注册