> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 已知问题

> Qualcomm® VSCode 扩展当前的限制和变通方法。

下表列出当前版本已确认的问题及推荐的变通方法。

| 问题                                       | 变通方法                                                              |
| ---------------------------------------- | ----------------------------------------------------------------- |
| IDE 不会下载 YOLO 模型                         | 手动将其下载到目标设备上的 `/etc/models`                                       |
| 扩展无法与 Ubuntu 上的 VS Code **Snap** 软件包配合使用 | 安装 `.deb` 软件包 — 参阅[在 Ubuntu 上安装 VS Code](../setup/install-vscode) |
| 开发套件出厂时固件可能过旧                            | 使用[入门向导](../quick-start)烧录最新镜像                                    |
| 烧录后初始化脚本不会自动运行                           | 烧录后，运行 **Dashboard → SDK → Configure Device**                     |
| 使用 QLI 1.3 或更早版本的 Rubik Pi 需要额外的 UFS 配置  | 在使用扩展之前，请在 IDE **之外**完成 UFS 配置步骤                                  |
| 在 macOS / UTM 环境中的测试有限                   | 为获得最佳体验，请使用 Ubuntu 22.04 或 Windows + WSL                          |
| 在 Ubuntu 24.04 主机上的测试有限                  | Ubuntu 22.04 是推荐且经过完整测试的主机                                        |

<Note>
  对于运行 Qualcomm Linux 软件版本 **1.3 或更早版本**的设备，需要在 IDE 之外执行额外的 UFS 配置和 CDT 编程步骤。这些步骤请参阅 [Qualcomm 开发者文档](https://developer.qualcomm.com)。
</Note>