- 安装问题
- 构建与运行问题
安装脚本下载失败
原因: 网络限制、企业防火墙阻止下载,或DNS解析问题导致无法访问sdk-installer.vega.labcollab.net。解决方案:-
检查网络连接:
- 如果企业防火墙阻止下载,请联系您的IT部门将该域名列入许可名单。
-
请确认您在Ubuntu上使用的是否是Snap版本的curl(此版本存在沙盒限制):
如果显示快照路径,请安装原生curl:
- 重试SDK安装 重新运行安装Vega SDK中的安装命令。
在系统引导初始化阶段,SDK安装失败。
原因: 在安装Vega CLI后,系统会自动下载SDK,在此期间出现网络连接、防火墙限制或权限不足问题。解决方案:-
检查网络连接:
- 如果企业防火墙阻止下载,请联系您的IT部门将该域名列入许可名单。
-
请确认您在Ubuntu上使用的是否是Snap版本的curl(此版本存在沙盒限制):
如果显示快照路径,请安装原生curl:
- 重新运行安装Vega SDK中的安装命令。
无法下载Vega CLI
原因: 网络限制、企业防火墙阻止下载,或者存在安装脚本访问权限问题,导致无法安装CLI二进制文件。解决方案: 使用传统的引导程序设置: 安装Vega SDKHomebrew安装
尝试安装Homebrew时,您可能会看到以下消息:- 禁用Rosetta。
- 按照Homebrew页面中的说明安装brew。
-
验证brew是否在您的
PATHPATH上。路径应该是: arm64: 在下/opt/homebrew/bin/brew方安装 Homebrew。 x86_64: 在下/usr/local/bin/brew方安装 Homebrew。 -
在**.profile/.rc**文件中正确设置
HOMEBREWHOMEBREW变量。 arm64:x86_64: -
更新您的brew软件包。
SDK下载错误
安装SDK期间出现平台不匹配错误。
-
验证您的终端是否在Rosetta下运行:
- 在M系列Mac上,如果返回
x86_64,则说明您的终端运行在Rosetta环境中。 - 在M系列Mac上,如果返回
arm64,则说明您的终端运行在原生环境中。
- 在M系列Mac上,如果返回
-
如果您的终端已启用Rosetta,请将其禁用:
a. 完全退出Terminal/iTerm
b. 右键点击“应用程序”中的Terminal.app(或iTerm.app)
c. 选择Get Info(显示简介)
d. 如果已启用Open using Rosetta(使用Rosetta打开),请取消勾选
e. 重新打开Terminal并使用
uname -m进行验证(应显示arm64) -
重新运行安装命令:
- 确认安装脚本准确识别到您设备的原生架构。
升级到macOS 27后Vega工具出现故障
原因: 从macOS 26升级到macOS 27会移除多个Vega DevKit组件所依赖的Rosetta。这可能会使原生调试和VDA等工具处于损坏状态。新安装的SDK不会受到影响,因为它们会在安装过程中将Rosetta作为依赖项安装。解决方案: 重新安装Rosetta,然后重启终端:安装期间下载失败
如果下载期间发生安装进程中止或失败,您可能会看到:- 安装停滞且无进度。
- 网络相关错误消息。
- 未完成的下载通知。
- 按Command+C (Mac) 或Ctrl+C (Linux) 终止安装。
- 连接至可靠网络。
- 恢复SDK安装 返回安装Vega SDK页面。
- 重新运行安装程序。
磁盘空间不足导致安装失败
- 释放磁盘空间。
- 清理磁盘空间后,确认可用空间至少剩余20GB。
- 重新运行安装程序。
SDK安装完成
- 存在之前安装的版本。
- 之前安装失败但未删除文件。
- 多次尝试过安装。
- 当提示替换所有现有文件时,输入
yy。
- 将现有文件夹备份到其他位置。
- 使用删除旧的安装程序。
- 重新运行安装程序。

