tensile/support/trobleshooting

.. meta::

:description: Tensile 常见问题排查，包括工具链缺失及环境配置

:keywords: Troubleshoot Tensile, Tensile support, Tensile help, Tensile troubleshooting, Tensile issues

.. _troubleshooting:

---

故障排查 (Troubleshooting)

---

本节提供帮助程序员和用户解决 Tensile 常见问题的信息。

=============================

缺失工具链组件 (Missing toolchain components)

======================================

示例错误：

.. code-block::

FileNotFoundError: `amdclang++` either not found or not executable in any search path

此错误意味着 Tensile 无法找到执行程序所需的一个或多个二进制文件，包括编译器、汇编器、链接器或打包工具。

.. note::

* Linux 默认安装路径：`/opt/rocm`

* Windows 默认安装路径：`C:\\Program Files\\AMD\\ROCm\\X.Y`，其中 `X.Y` 为 ROCm 的主版本和次版本号。

安装 Windows HIP SDK 后，系统会设置 `HIP_PATH` 指向 HIP SDK 安装目录。

造成此错误的原因通常有两种：

1. 系统未安装 ROCm。解决方法：参照 :ref:`install-rocm` 安装 ROCm。

2. ROCm 已安装，但安装路径非默认路径，系统 `PATH` 中找不到相应二进制文件。

此时需要将安装路径添加到环境变量中：

* **Linux**:

.. code-block:: shell

export ROCM_PATH=<path_to_rocm>

* **Windows PowerShell**:

.. code-block:: powershell

$env:HIP_PATH = "<path_to_rocm>\bin"