- 安装问题
- 构建与运行问题
安装脚本下载失败
原因： 网络限制、企业防火墙阻止下载，或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是否在您的
PATH上。路径应该是： 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，请将其禁用：
a. 完全退出Terminal/iTerm
b. 右键点击“应用程序”中的Terminal.app（或iTerm.app）
c. 选择显示简介
d. 取消选中使用Rosetta打开（如果已启用Rosetta）
e. 重新打开Terminal，运行
uname -m进行验证（应该返回arm64） -
重新运行安装命令：
- 确认安装脚本准确识别到您设备的原生架构。
安装期间下载失败
如果下载期间发生安装进程中止或失败，您可能会看到：- 安装停滞且无进度。
- 网络相关错误消息。
- 未完成的下载通知。
- 按Command+C (Mac) 或Ctrl+C (Linux) 终止安装。
- 连接至可靠网络。
- 恢复SDK安装 返回安装Vega SDK页面。
- 重新运行安装程序。
磁盘空间不足导致安装失败
- 释放磁盘空间。
- 清理磁盘空间后，确认可用空间至少剩余20GB。
- 重新运行安装程序。
SDK安装完成
- 存在之前安装的版本。
- 之前安装失败但未删除文件。
- 多次尝试过安装。
- 当提示替换所有现有文件时，输入
y。
- 将现有文件夹备份到其他位置。
- 使用rm -rf<安装路径>移除旧版本。
- 重新运行安装程序。
