Vivado/Vitis 2026.1 避坑指南

坑点一：安装后执行`installLibs.sh`脚本报错

Vitis 安装完成后，系统会提示运行installLibs.sh。在 Ubuntu 下，实际应使用命令：

sudobashinstallLibs.sh

但执行时可能遇到如下错误：

installLibs.sh: line 5: $'\r': command not found installLibs.sh: line 32: syntax error near unexpected token `elif' installLibs.sh: line 32: `elif [ -f /etc/os-release ] ; then

原因：该脚本使用了 Windows 风格的行尾符（\r\n），而非 Unix 风格（\n）。Bash 会将多余的\r解释为命令的一部分，从而引发“command not found”；后续的elif语法错误同样源于这些多余字符干扰了解析器。

解决方法：将脚本转换为 Unix 行尾格式。在脚本所在目录下，任选以下一种方式处理：

若已安装dos2unix：
```
dos2unix installLibs.sh
```
使用sed（直接修改原文件）：
```
sed-i's/\r$//'installLibs.sh
```

使用tr（生成新文件后覆盖）：

tr-d'\r'<installLibs.sh>installLibs_fixed.sh&&mvinstallLibs_fixed.sh installLibs.sh

转换完成后，$'\r'报错即可消除，脚本可正常执行。

坑点二：License 配置

通过 AMD 官方许可证申请页面（https://account.amd.com/en/forms/license/license-form.html）获取Xilinx.lic文件后，无需额外启动 FlexLM 服务或运行任何后台程序。只需将该文件保存到用户主目录下的隐藏文件夹~/.Xilinx/中，工具即可自动识别并生效。

总结：以上两点是 2026.1 版本常见的初始设置问题，按上述步骤操作即可顺利避开。

Vivado/Vitis 2026.1 避坑指南