为什么 HBuilderX 运行会报错Unexpected token '??='

欢迎到专业群（ HBuilderX技术交流群 ） 咨询，群中有相关专业的管理员和群友。

这个错误的核心原因是Node.js 版本不兼容导致的问题。

??= 是 ES2021 引入的逻辑空赋值运算符，这个语法特性需要 Node.js 15.0.0 或更高版本才能支持。

从你的报错堆栈可以看到关键信息：

at wrapSafe (internal/modules/cjs/loader.js:1001:16)

本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent

这个 internal/modules/cjs/loader.js 是 Node.js 14 版本及之前的模块加载器路径格式。虽然你提到本地 Node 是 24.12.0，HBuilderX 内置 Node 是 22 版本，但实际运行编译任务的 Node 进程可能是另一个更老的版本。

原因分析

HBuilderX 在运行项目时，并不是简单使用内置的 Node 22 来执行所有任务。某些编译子进程可能会调用系统环境变量中配置的 Node.js 版本，或者 HBuilderX 自带的某个旧版 Node。从堆栈路径 internal/modules/cjs/loader.js:1001 来看，实际执行代码的 Node 版本很可能是 v14.x，这个版本不支持 ??= 运算符，因此解析 unimport 包时报错。

解决方案

1. 检查并统一系统 Node 版本环境变量

打开终端（cmd/powershell），执行以下命令：

node -v  
where node

本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent
查看系统 PATH 中指向的是哪个 Node 版本。如果存在旧版本的 Node.js（如 v14），建议将其从系统环境变量中移除，或确保 HBuilderX 相关进程优先使用高版本 Node。

2. 在 HBuilderX 中设置运行配置

进入 HBuilderX 菜单栏 → 设置 → 运行配置，在 "Node 路径" 或 "npm 路径" 中，手动指定为你的 Node 24 或 HBuilderX 内置的 Node 22 的完整路径。

3. 清理缓存并重新安装依赖

# 删除 node_modules 和 lock 文件  
rm -rf node_modules package-lock.json  
# 或 Windows 上  
# rmdir /s /q node_modules  
# del package-lock.json  

# 重新安装依赖  
npm install

本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent

4. 临时降级 unimport 版本（如果上述方法无效）

在 package.json 中指定一个兼容旧 Node 的 unimport 版本：

"overrides": {  
  "unimport": "3.7.1"  
}

本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent
然后重新执行 npm install。

5. 检查 HBuilderX 版本

你当前使用的是 HBuilderX 5.07 正式版。可以尝试升级到最新的 HBuilderX Alpha 5.12 版本，新版通常会修复这类内置 Node 版本调度的问题。

如果以上方法都无法解决，建议重启 HBuilderX 后重新运行项目，确保所有进程都使用正确版本的 Node.js。