点击发行---运行到安卓或iOS，点击打包
w***@stesh.cn
- 发布：2026-04-08 09:47
- 更新：2026-04-09 16:00
- 阅读：82
产品分类： uniapp/App
PC开发环境操作系统： Windows
PC开发环境操作系统版本号： Windows 10
HBuilderX类型： 正式
HBuilderX版本号： 5.06
手机系统： iOS
手机系统版本号： iOS 18
手机厂商： 苹果
手机机型： iphone
页面类型： vue
vue版本： vue3
打包方式： 云端
项目创建方式： HBuilderX
操作步骤：
预期结果：
能编译成功
能编译成功
实际结果：
编译失败
编译失败
bug描述：
使用的vue3+vite开发的app，在云打包iOS版本，进行编译时，一直报这个错误，是什么原因，怎么解决？？[HBuilder] 09:41:40.133 项目 'zcyun-iot-app' 开始编译...
[HBuilder] 09:41:42.517 编译器版本：5.06（vue3）
[HBuilder] 09:41:42.530 正在编译中...
[HBuilder] 09:41:44.149 failed to load config from D:\device\uni-app\zcyun-iot-app\vite.config.js
[HBuilder] 09:41:44.162 createUniXSwiftCompilerOnce is not a function
[HBuilder] 09:41:44.172 Build failed with errors.
2 个回复
张柏慈 - 会打代码
您在使用HBuilderX 5.06进行Vue3 Vite项目的iOS云打包时遇到两个关键错误：
failed to load config from D:\device\uni-app\zcyun-iot-app\vite.config.js
createUniXSwiftCompilerOnce is not a function
这表明系统无法正确读取Vite配置且iOS编译环境存在功能缺失。
解决方案
一、基础修复步骤
检查Vite配置文件
确认项目根目录存在有效的vite.config.js
确保文件导出格式正确（Vue3应使用ESM格式）：
javascript
import { defineConfig } from 'vite'
export default defineConfig({
// 配置内容
})
清理缓存文件
删除node_modules和package-lock.json
执行以下命令：
bash
npm cache clean --force
npm install
二、iOS特定问题处理
更新HBuilderX至最新版
当前5.06版本可能存在Swift编译兼容性问题
建议升级到官方最新稳定版
检查uni-app编译器版本
在manifest.json中确认使用Vue3编译器：
json
{
"vueVersion": "3"
}
三、高级排查方案
手动指定Vite配置路径
在项目根目录创建hbuilderx.config.js：
javascript
module.exports = {
vite: {
configFile: './vite.config.js'
}
}
检查依赖冲突
确保关键依赖版本匹配：
json
"dependencies": {
"@dcloudio/uni-app": "^3.0.0",
"vite": "^4.0.0"
}
四、替代方案
如仍无法解决，可尝试：
改用本地打包（需配置Xcode环境）
创建全新项目逐步迁移代码
使用HBuilderX Alpha版测试
预防措施
定期备份项目配置
使用版本控制管理依赖变更
如需更具体的帮助，建议提供：
完整的vite.config.js内容
package.json依赖列表
完整的错误日志截图
w***@stesh.cn (作者)
改用了5.05,5.06,5.04，这三个版本都一样的错误，根目录下确定有vite.config.js，我将vite.config.js这个改为最基础的，也是报这个错误，下面的就是完整的错误日志：[HBuilder] 15:49:44.342 项目 'zcyun-iot-app' 开始编译...
[HBuilder] 15:49:48.674 编译器版本：5.05（vue3）
[HBuilder] 15:49:48.688 正在编译中...
[HBuilder] 15:49:50.258 failed to load config from D:\device\uni-app\zcyun-iot-app\vite.config.js
[HBuilder] 15:49:50.271 createUniXSwiftCompilerOnce is not a function
[HBuilder] 15:49:50.282 Build failed with errors.