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

